curl --request POST \
--url https://public-api.stora.co/2025-09/timeline/events \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": {
"id": "tsrc_126b43585fea94ad"
},
"template": {
"id": "aetpl_6b92d7693eb7e8e9"
},
"contact": {
"id": "con_9bc5a9d2d8302840"
},
"site": {
"id": "site_14b419f1096013f1"
},
"description": "CRM deal moved to Negotiation stage",
"external": {
"id": "deal_98442",
"url": "https://crm.example.com/deals/98442"
},
"variables": {
"deal_name": "10x10 Unit — 12 months",
"previous_state": "Qualified",
"new_state": "Negotiation"
}
}
'{
"event": {
"id": "aevt_327151655672f2cc",
"contact": {
"id": "con_9bc5a9d2d8302840"
},
"created_at": "2025-02-22T14:41:00Z",
"creator": {
"id": "app_99b90b9d208a137b"
},
"description": "CRM deal moved to Negotiation stage",
"external": {
"id": "deal_98442",
"url": "https://crm.example.com/deals/98442"
},
"invoice": null,
"site": {
"id": "site_14b419f1096013f1"
},
"source": {
"id": "tsrc_126b43585fea94ad"
},
"subscription": null,
"template": {
"id": "aetpl_6b92d7693eb7e8e9"
},
"tenancy": null,
"unit": null,
"unit_type": null,
"updated_at": "2025-02-22T14:41:00Z",
"variables": {
"deal_name": "10x10 Unit — 12 months",
"previous_state": "Qualified",
"new_state": "Negotiation"
}
},
"meta": {
"request_id": "01563646-58c1-4607-8fe0-cae3e92c4477",
"curies": [
{
"name": "bo",
"href": "https://app.stora.test{rel}",
"templated": true,
"title": "Backoffice"
},
{
"name": "sf",
"href": "https://acme.stora.test{rel}",
"templated": true,
"title": "Storefront"
}
]
}
}Create a new timeline event from an external source.
Check the template you want to use to see which required pre-defined variables it includes. Custom variables are not enforced on creation.
Required authorization scope: public.timeline_event:write
curl --request POST \
--url https://public-api.stora.co/2025-09/timeline/events \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": {
"id": "tsrc_126b43585fea94ad"
},
"template": {
"id": "aetpl_6b92d7693eb7e8e9"
},
"contact": {
"id": "con_9bc5a9d2d8302840"
},
"site": {
"id": "site_14b419f1096013f1"
},
"description": "CRM deal moved to Negotiation stage",
"external": {
"id": "deal_98442",
"url": "https://crm.example.com/deals/98442"
},
"variables": {
"deal_name": "10x10 Unit — 12 months",
"previous_state": "Qualified",
"new_state": "Negotiation"
}
}
'{
"event": {
"id": "aevt_327151655672f2cc",
"contact": {
"id": "con_9bc5a9d2d8302840"
},
"created_at": "2025-02-22T14:41:00Z",
"creator": {
"id": "app_99b90b9d208a137b"
},
"description": "CRM deal moved to Negotiation stage",
"external": {
"id": "deal_98442",
"url": "https://crm.example.com/deals/98442"
},
"invoice": null,
"site": {
"id": "site_14b419f1096013f1"
},
"source": {
"id": "tsrc_126b43585fea94ad"
},
"subscription": null,
"template": {
"id": "aetpl_6b92d7693eb7e8e9"
},
"tenancy": null,
"unit": null,
"unit_type": null,
"updated_at": "2025-02-22T14:41:00Z",
"variables": {
"deal_name": "10x10 Unit — 12 months",
"previous_state": "Qualified",
"new_state": "Negotiation"
}
},
"meta": {
"request_id": "01563646-58c1-4607-8fe0-cae3e92c4477",
"curies": [
{
"name": "bo",
"href": "https://app.stora.test{rel}",
"templated": true,
"title": "Backoffice"
},
{
"name": "sf",
"href": "https://acme.stora.test{rel}",
"templated": true,
"title": "Storefront"
}
]
}
}Bearer Token necessary to use API
This endpoint supports expandable responses. For more, see the documentation page.
Create Event Request
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Was this page helpful?