Bulk Upload Delivery Jobs
POST/delivery/jobs/bulk-upload
This endpoint allows you to bulk create delivery jobs (up to 1000 jobs per request) from an Excel/CSV file. Parameters in the file are exactly the same as POST /delivery/jobs endpoint, you may refer to it for more details.
When a record cannot be created, the webhook reports it with reference_number and an errors text, which is one of these exact texts. "Job creation result unknown. Check these reference numbers with GET /delivery/jobs before retrying." means the request could not be completed, its answer could not be read, or it ended with an error after some of the records may have been saved, so the jobs may have been created and must be checked before a retry. "Job creation failed. Please retry these records." means the request was not accepted, so no job was created and you can retry them. "Missing bulk create result" means no result was returned for that record. "Job creation failed for this record." means that single record failed unexpectedly.
Request
Responses
- 200
- 401
- 403
- 404
- 422
- 500
- 503
Successful operation
Unauthorized access. Authentication is required.
Access is forbidden. The user does not have permission to access this resource. Delivery write endpoints also return this error when the request is authenticated with a subuser api_key, which cannot write to Delivery; in that case error.message is Unauthorized and error.data.message is Unauthorized for this role. Authenticate with the main account's api_key and, where supported, set the subuser_id body field to act on behalf of a subuser.
The requested resource was not found.
Validation failed for the input parameters.
Internal server error.
Service temporarily unavailable. The request did not complete and can be retried after the number of seconds in the Retry-After header, when one is sent.
Response Headers
Seconds to wait before retrying. Sent with db_busy and db_pool_timeout.