Loading...
Skip to main content

Add users

Ingest user data into a Bulk Job

URL: https://api.courier.com/bulk/:job_id

Method: POST

Path Parameters

job_idstringrequired
A unique identifier representing the bulk job

Body Parameters

usersarray
User data ingestion for the job
+ Show Properties

Responses

status: 200 OK

errorsarray
Errors occurred during job data ingestion
totalnumber
Total count of users that have been successfully ingested

status: 400 Bad Request

messagestring
A message describing the error that occurred.
typestring
[invalid_request_error] The type of error that occurred.

Request Example

curl --request POST \
--url https://api.courier.com/bulk/1-61e9dd53-b5bb6c863b7ffbe83ad4b28d \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '
{
"users": [
{
"recipient": "8ec8c99a-c5f7-455b-9f60-8222b8a27056",
"profile": {
"phone_number": "2025550125",
"email": "hello@example.com"
},
"data": {
"name": "Jane Doe",
"age": 27
},
"to": {
"email": "tejas@courier.com"
}
}
]
}
'

Responses Example

{
"errors": [
{
"error": "Duplicate user",
"user": {
"email": "u1@courier.com",
"user_id": "u1",
"data": {
"recipientName": "Foo"
}
}
}
]
}
{
"message": "Error Message",
"type": "invalid_request_error"
}

Example

Method: POST

URL: https://api.courier.com/bulk/1-61e9dd53-b5bb6c863b7ffbe83ad4b28d

Body: ​

{
"users": [
{
"recipient": "8ec8c99a-c5f7-455b-9f60-8222b8a27056",
"profile": {
"phone_number": "2025550125",
"email": "hello@example.com"
},
"data": {
"name": "Jane Doe",
"age": 27
},
"to": {
"email": "tejas@courier.com"
}
}
]
}