Trigger message delivery workflow
Méthode 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.
Autorisation
Scope requis
containers:notify
Use Authorization: Bearer liv_<prefix>_<secret>.
Paramètres
| Nom | Emplacement | Type | Requis | Contraintes | Description |
|---|---|---|---|---|---|
crid |
Chemin | string |
Requis | Business reference of the container. |
Corps de la requête
| Nom | Type | Requis | Description |
|---|---|---|---|
sender |
SenderInput
|
Facultatif | Optional sender identity and contact values. |
recipient |
RecipientInput
|
Facultatif |
Optional recipient identity and contact values. With no channel, email is
selected when present. A phone-only recipient must set channel to sms.
|
Réponses
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"
}
}