Substy Developers
Creators

Deliver custom order

Queue fulfillment of a fully paid custom order with 1–20 unique media IDs belonging to its creator and matching its format. Media is sent without a second charge. Repeating the action returns the same receipt while it is queued or sent; after a failed send it registers a new attempt. Refresh the order to verify platform-confirmed delivery or failure.

POST/v1/agencies/{agencyId}/creators/{creatorId}/customs/orders/{orderId}/delivery

Queue fulfillment of a fully paid custom order with 1–20 unique media IDs belonging to its creator and matching its format. Media is sent without a second charge. Repeating the action returns the same receipt while it is queued or sent; after a failed send it registers a new attempt. Refresh the order to verify platform-confirmed delivery or failure.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

agencyId*string
Length1 <= length
creatorId*string
Length1 <= length
orderId*string
Length1 <= length

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/agencies/string/creators/string/customs/orders/string/delivery" \  -H "Authorization: Bearer YOUR_API_KEY" \  -H "Content-Type: application/json" \  -d '{    "mediaIds": [      "string"    ]  }'
{  "data": {    "id": "string",    "type": "delivered",    "amount": null,    "days": null,    "mediaIds": [      "string"    ],    "retryNumber": 0,    "appliedAt": null,    "queuedAt": null,    "sentAt": null,    "skippedAt": null,    "failedAt": null,    "lastError": null,    "createdAt": "2019-08-24T14:15:22Z"  },  "meta": {    "requestId": "string",    "operationId": "3051932a-fdd2-48fa-b330-7e7d41535969",    "status": "COMPLETED"  }}

Set custom order deadline POST

Register an ETA of 1–365 days for a fully paid custom order. Returns an asynchronous event receipt; refresh the order to confirm processing and the fan notification.

Retry custom order delivery POST

Send a custom order delivery again after its last attempt failed, with the same media. Returns the new attempt’s receipt (retryNumber counts the retries); fails when no delivery failed. Refresh the order to verify platform-confirmed delivery.