/v1/workspaces/{workspace_id}/contacts/importsAuthList contact imports, newest first
Path parameters
workspace_id*string · uuidId of the workspace.
Query parameters
limitintegerPage size. Defaults to 20; values above 100 are clamped to 100.
cursorstringOpaque cursor from the previous page's `pagination.next_cursor`. Omit for the first page.
Response · 200
data*arrayThe imports on this page, newest first.
pagination*objectnext_cursor*stringOpaque cursor for the next page. `null` when no more pages are available.
Example: "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ"
has_more*booleanTrue iff another page exists; if true, pass `next_cursor` on the next request.
Example: false
Example
Request
GET https://api.mail.productcraft.co/v1/workspaces/{workspace_id}/contacts/imports
Authorization: Bearer YOUR_TOKENResponse
{
"data": [
{
"id": "00000000-0000-0000-0000-000000000000",
"status": {},
"on_conflict": {},
"filename": "string",
"size_bytes": 0,
"consent_source": "string",
"topic_ids": [
"00000000-0000-0000-0000-000000000000"
],
"total_rows": 0,
"processed_rows": 0,
"created_count": 0,
"updated_count": 0,
"skipped_count": 0,
"error_count": 0,
"consented_count": 0,
"errors": [
{
"line": 0,
"error": "invalid or missing email"
}
],
"failure_reason": "string",
"created_at": "2026-01-01T00:00:00.000Z",
"started_at": "2026-01-01T00:00:00.000Z",
"completed_at": "2026-01-01T00:00:00.000Z"
}
],
"pagination": {
"next_cursor": "eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQwMDowMDowMFoifQ",
"has_more": false
}
}