Bulk Import

Import contacts from CSV

Manage contact import jobs

Import contacts

post

Import contacts in bulk with support for custom fields and list management. Existing contacts with matching email addresses will be updated automatically. You can import up to 50,000 contacts per request. The import process runs asynchronously - use the returned import ID to check the status and results.

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

account_idinteger · int64 · min: 1Required

Unique account ID

Example: 3229

Body

application/json

Responses

201

Contact Import created successfully.

application/json

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

422

Returns validation errors.

application/json

500

Internal error. Retry later or contact support.

application/json

post

/api/accounts/{account_id}/contacts/imports

Node.jsPHPPythonRubyC#Java

const { MailtrapClient } = require("mailtrap");
const client = new MailtrapClient({ token: "YOUR_API_KEY", accountId: YOUR_ACCOUNT_ID });
const importJob = await client.contacts.imports.create({
  contacts: [
    { email: "[email protected]", fields: { first_name: "John" }, list_ids_included: [1, 2] },
    { email: "[email protected]", fields: { first_name: "Jane" }, list_ids_included: [1] }
  ]
});
console.log(`Import started: ${importJob.id}`);

{
  "id": 1,
  "status": "started"
}

Get Contact Import

get

Get Contact Import

Authorizations

HeaderAuthBearerAuth

Api-TokenstringRequired

Pass the API token in the Api-Token

Path parameters

account_idinteger · int64 · min: 1Required

Unique account ID

Example: 3229

import_idinteger · int64Required

Unique Contact Import ID

Example: 3229

Responses

200

OK.

application/json

401

Returns unauthorized error message. Check your credentials.

application/json

403

Returns forbidden error message. Check your permissions.

application/json

404

Resource not found

application/json

500

Internal error. Retry later or contact support.

application/json

get

/api/accounts/{account_id}/contacts/imports/{import_id}

Node.jsPHPPythonRubyC#Java

const { MailtrapClient } = require("mailtrap");
const client = new MailtrapClient({ token: "YOUR_API_KEY", accountId: YOUR_ACCOUNT_ID });
const importStatus = await client.contacts.imports.get(importId);
console.log(`Status: ${importStatus.status}, Created: ${importStatus.created_contacts_count}`);

{
  "id": 1,
  "status": "started"
}