PricingDocsCompareGuidesBlog
API referenceContacts

List contact imports

GET/contacts/imports

Authorization

apiKey
AuthorizationBearer <token>

A project API key: Authorization: Bearer s0_…

In: header

Query Parameters

limit?integer
Range1 <= value <= 100
after?string
Length1 <= length <= 64
before?string
Length1 <= length <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/contacts/imports"
{  "object": "list",  "has_more": true,  "data": [    {      "object": "contact_import",      "id": "string",      "status": "uploading",      "filename": "string",      "consent": "string",      "list_ids": [        "string"      ],      "update_existing": true,      "size_bytes": 0,      "columns": {        "fields": {          "property1": "string",          "property2": "string"        },        "properties": [          "string"        ],        "ignored": [          "string"        ]      },      "rows_processed": 0,      "rows_created": 0,      "rows_updated": 0,      "rows_skipped": 0,      "rows_failed": 0,      "error": "string",      "created_at": "2019-08-24T14:15:22Z",      "started_at": "2019-08-24T14:15:22Z",      "completed_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    }  ]}

Retrieve an API request log GET

Resend's log shape; `request_body` and `response_body` are always null because bodies are not stored.

Import contacts from CSV POST

Send the CSV (up to 50 MB) as the body with `Content-Type: text/csv`. `consent` is required: how these people agreed to receive marketing email. The file needs an email column; other columns map to names, `unsubscribed`, `external_id` and properties by name. Imports run in the background.