SUPPORT.TWILIO.COM END OF LIFE NOTICE: This site, support.twilio.com, is scheduled to go End of Life on February 27, 2024. All Twilio Support content has been migrated to help.twilio.com, where you can continue to find helpful Support articles, API docs, and Twilio blog content, and escalate your issues to our Support team. We encourage you to update your bookmarks and begin using the new site today for all your Twilio Support needs.

How do I create a custom voice log archive job?

Objective

This article explains how to request a one-off export of your voice activity logs for a specific date range, so you can download call, conference, or conference participant records as JSON archive files.

 

Product

Programmable Voice

 

Environment

Twilio Console

 

User Account Permission/Role(s) Required

Your user role must allow reading Voice settings.

 

Procedure

  1. In the Twilio Console, select Communications in the left sidebar.
  2. Select Voice, then Settings.
  3. Select Log archives, then Custom jobs.
  4. Select Create custom job. A Create custom job form opens.
  5. Under Export type, choose Calls, Conferences, or Conference participants. Calls is selected by default.
  6. Enter a Friendly name, a unique identifier for this export job.
  7. Under Date range, set a Start date and an End date.
  8. Optionally, under Configure Notifications, enter a Webhook URL and choose an HTTP method (POST or GET), and enter an Email address, to be notified when the files are ready.
  9. Select Generate files.
  10. A confirmation appears reading "Custom job created" with the message "The custom job has been created successfully.", and the form closes. The job appears in the Past Jobs table.

 

Additional Information

  • Export type, Friendly name, Start date, and End date are all required. Submitting the form empty keeps it open.
  • The end date must be on or after the start date. Otherwise you see "End Date must be a date after the Start Date".
  • Each file covers a single 24-hour period based on the UTC timezone. Dates within the last two days cannot be exported yet.
  • Generating files may take several hours, which is why the webhook and email notification fields are offered.
  • If the date range overlaps an export you already requested, an Overlapping export request message explains the conflict.
  • Files are removed automatically after seven days.
  • Log archives are available only in the United States (US1) region.

 

This content was generated by AI and reviewed, edited, and verified by a human.

Have more questions? Submit a request
Powered by Zendesk