Build an export
1
Choose the data you need
Start with a published API resource or a
report recipe.
Select the fields and filters your destination needs, and choose a refresh
interval that fits your reporting requirements.
2
Authenticate your integration
Create a service account for the export and grant only the permissions it
needs. Follow the API quickstart to make your
first request with an API key. See
Authentication if your security policy
requires OAuth access tokens.
3
Read all pages
Follow the pagination guide to collect a
complete result set. Keep filters consistent while following a cursor,
handle cursor expiry, and account for records changing during a read.
4
Schedule and monitor refreshes
Schedule requests in your integration and follow the
rate-limit and retry guidance.
Record refresh outcomes and request IDs so you can investigate failed or
incomplete exports. Keep credentials and exported personal data out of logs.
Protect exported data
Use the regional API host for your organization. Review the destination’s access controls and retention policy before sending personal data to it. Store API credentials in a secret manager, and rotate or revoke them when the integration changes. When requesting help with an export, include the operation, HTTP status andRequest-Id. Do not include API keys, access tokens or exported personal data.
