Add a contributor
This endpoint allows you to add new contacts or existing contacts as contributors of a request.
Body
-
The ID of the request you want to add the contributor to.
-
An array of the contributors you want to add to the request. You can add up to 10 contributors per API cal. Each contributors can be a string representing the ID of an existing contact or a contact object in JSON format. (click here for more details)
Responses
-
List of requests of a campaigns.
-
Bad Request -- Your request is invalid.
-
Unauthorized -- Your API key is wrong.
-
Forbidden -- The object requested is hidden for administrators only.
-
Not Found -- The specified object could not be found.
-
Too Many Requests -- You're requesting too many objects! Slow down!
-
Internal Server Error -- We had a problem with our server. Try again later.
-
Service Unavailable -- We're temporarily offline for maintenance. Please try again later.
curl \
--request POST 'https://api.usecollect.com/v1/contributors' \
--user "username:password" \
--header "Content-Type: application/json" \
--data '{"contact":{"data":{"brand":"Bachmanity","model":"Roadster"},"email":"erlich.bachman@example.com","company":"Bachmanity","lastName":"Bachman","firstName":"Erlich"},"requestId":"xvr69EYLKXvTkfYuk"}'
{
"contact": {
"data": {
"brand": "Bachmanity",
"model": "Roadster"
},
"email": "erlich.bachman@example.com",
"company": "Bachmanity",
"lastName": "Bachman",
"firstName": "Erlich"
},
"requestId": "xvr69EYLKXvTkfYuk"
}
{
"contact": "WmTjsFknzHdmfs3Ra",
"requestId": "xvr69EYLKXvTkfYuk"
}
{
"errors": [],
"request": {
"_id": "nw42MmBsJoccgutST",
"status": "pending",
"contact": {
"_id": "xtPWKQqcAk8MJfoz5",
"email": "jared.dunn@example.com",
"lastName": "Dunn",
"createdAt": "2024-12-03T13:51:27Z",
"firstName": "Jared",
"nbRequest": 5,
"lastActivity": "2024-12-04T07:20:06Z"
},
"dueDate": "2024-12-11T21:59:00Z",
"privacy": "private",
"branding": {
"useBranding": false
},
"createdAt": "2024-12-04T07:20:06Z",
"portalUrl": "https://app.usecollect.com/portal/uGFRDeEL3Ct2uYo2c/nw42MmBsJoccgutST/c/Mz6oP9sU4xY7aB0u",
"campaignId": "xvr69EYLKXvTkfYuk",
"contributors": [
{
"_id": "WmTjsFknzHdmfs3Ra",
"email": "gilfoyle@example.com",
"lastName": "Gilfoyle",
"createdAt": "2024-12-03T13:51:27Z",
"firstName": "Bertram"
}
]
}
}