Export Brand Contacts
GET/api/v2/brands/:brand/contacts/export
Download all contacts belonging to the brand as a CSV or XLSX file. Columns: Contact ID, Name, Email, Phone, Role, Title, Primary, Notes, Created At, Updated At. The file mirrors the contacts bulk-import template, so an exported file can be edited and re-imported (rows with a Contact ID or a matching email update the existing contact; others are created).
reports:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Optional comma-separated column keys (name,role,title,email,phone,notes,created_at) to narrow the exported fields; Contact ID is always included so the file can round-trip as an update. Omit for the full field set.
Optional. filtered applies the request's filter/sort parameters (same syntax as the list endpoint) instead of exporting every contact.
Brand contacts use the role report_recipient for people who receive the brand's reports (the primary contact is addressed in the email greeting). Requires permission brand_reports.manage.
Request
Responses
- 200
- 401
- 403
- 404
- 429
Successful response
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.