Trigger message delivery workflow
Method POST https://client-api.v5.livstick.com/api/v3/containers/{crid}/notify
Trigger downstream delivery for the recorded message. The request body is optional: without it, contacts already stored on the message are reused; when provided, typed contact values override the stored values before delivery is triggered.
Authorization
Required scope
containers:notify
Use Authorization: Bearer liv_<prefix>_<secret>.
Parameters
| Name | In | Type | Required | Constraints | Description |
|---|---|---|---|---|---|
crid |
Path | string |
Required | Business reference of the container. |
Request body
| Name | Type | Required | Description |
|---|---|---|---|
sender |
SenderInput
|
Optional | Optional sender identity and contact values. |
recipient |
RecipientInput
|
Optional |
Optional recipient identity and contact values. With no channel, email is
selected when present. A phone-only recipient must set channel to sms.
|
Responses
Delivery workflow triggered.
Request rejected due to invalid payload or business precondition.
{
"error": {
"code": "DATA_INVALID",
"message": "Invalid request data"
}
}
Authentication failed or missing bearer token.
{
"error": {
"code": "UNAUTHORIZED",
"message": "Missing API key"
}
}
Authenticated but not allowed by scope or key constraints.
{
"error": {
"code": "FORBIDDEN",
"message": "Insufficient permissions"
}
}
Target container could not be found.
{
"error": {
"code": "NOT_FOUND",
"message": "Container not found for this CRID"
}
}