cURL
Python
JavaScript
PHP
Go
Java
Ruby
curl --request POST \
--url https://api.autosend.com/v1/contacts/bulk-update \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"contacts": [
{
"email": "john.doe@example.com",
"firstName": "John",
"lastName": "Doe",
"userId": "user_12345",
"customFields": {
"company": "Acme Corp",
"role": "Developer",
"plan": "premium"
}
}
],
"runWorkflow": false
}'
{
"success" : true ,
"data" : {
"successCount" : 1 ,
"failedCount" : 0 ,
"totalCount" : 1
}
}
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Array of contacts to update or create
Array of contact objects (minimum 1, maximum 100) Maximum 100 contacts per request.
Valid email address (automatically normalized to lowercase) Example: "john.doe@example.com"
Contact’s first name Example: "John"
Contact’s last name Example: "Doe"
Your application’s user identifier Example: "user_12345"
Custom contact attributes Example: {
"company" : "Acme Corp" ,
"role" : "Developer" ,
"plan" : "premium"
}
Whether to trigger workflows for updated contacts Example: false
Response
Bulk update completed
Number of successfully updated/created contacts Example: 1
Number of failed contacts Example: 0
Total number of contacts processed Example: 1