comecerodocs

Send an event again

POST
/events/{event_id}/retry

Sends the event to its event subscription now, with the same event_id and data, and answers with the event after the attempt. Check status: delivered if your server answered 2xx, otherwise failed. A failed manual attempt does not start automatic retries, but an event already waiting for a retry keeps its place in that queue. It uses the event subscription's current destination and settings. No body is needed. Events are kept for 30 days after their last change, and for 7 days once delivered or in test mode; after that the event is gone (404). Secret and trusted tokens may call it; a limited token may not (403).

Authorization

headerAuthorizationBearer <token>

A secret, trusted or limited token. See Authentication.

Path Parameters

event_id*string

The event id.

Query Parameters

debug?boolean

When true, the answer includes debug with why the attempt failed.

Defaultfalse
expand?string

Comma-separated child objects to return in full instead of as a URL, for example customer,payments. Use dot notation for nested objects (items.product), up to four levels deep. A single object takes up to 12 paths; a list takes up to 2, applied to every item. Extra paths are dropped without an error. See Expanding objects.

show?string

Comma-separated fields to return; all others are left out. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

hide?string

Comma-separated fields to leave out of the response. Use dot notation for child fields (customer.email). You cannot send show and hide together (400). See Customizing output.

formatted?boolean

When true, the object also has a formatted child with amounts and dates as display text in the shopper's language and currency (for example $19.99 or November 7, 2026). The default is false. See Localized formatting.

Defaultfalse

Response Body

The event after the attempt. A 200 means the attempt was made, not that it got through: read status.

application/json
  1. response

One delivery of one event to one event subscription. When something happens (an order is created, a payment completes), Comecero makes one event for each active event subscription to that event type, each with its own event_id and the same fingerprint. This is also the body Comecero POSTs to your webhook URL.

object?"event"

Always event.

Value in"event"
url?string

The URL of this event in the API.

Formaturi
event_id?string

The id of this delivery. It is different for each event subscription, and stays the same when the delivery is retried, so use it to ignore a delivery you already handled.

test?boolean

true for a test mode event.

account_id?string

The account the event belongs to.

type?event_type

The kind of event. See the Webhooks section of this reference for when each one fires and what its data holds.

Value in"account:modified""cart:payment_completed""gateway:created""gateway:modified""event_subscription:created""event_subscription:modified""event_subscription:deleted""license_service:low_licenses""invoice:created""invoice:published""invoice:paid""invoice:payment_completed""order:created""order:payment_completed""order:fulfilled""order:licenses_assigned""payment:completed""payment:created_success""payment:created_failure""payment:captured_success""payment:captured_failure""payment:voided""product:created""product:modified""product:deleted""product:low_inventory""refund:created_success""refund:created_failure""refund:deleted""user:created""user:modified""shipment:created""shipment:modified""shipment:deleted""subscription:created""subscription:modified""subscription:cancelled""subscription:cancellation_scheduled""subscription:cancellation_unscheduled""subscription:completed""subscription:converted""subscription_item:added""subscription_item:cancelled""subscription_item:cancellation_scheduled""subscription_item:cancellation_unscheduled""subscription_item:modified""subscription:renewal_success""subscription:renewal_failure"
event_subscription?|

The event subscription this delivery is for: its URL, or the full object when you send expand=event_subscription. Left out when the token may not read event subscriptions.

fingerprint?string

The id of the thing that happened. Every event subscription that receives the same occurrence gets the same fingerprint.

status?string

Where delivery stands. queued: made, not sent yet. delivered: your server answered 2xx (or the email was sent). retry: the last attempt failed and another is planned. failed: no more attempts will be made.

Value in"queued""delivered""retry""failed"
date_created?string

When the event happened. Dates in an event use the event subscription's timezone, or the account's time zone when it has none.

Formatdate-time
date_modified?string

When the event last changed, for example at its last delivery attempt.

Formatdate-time
environment_variables?|

The name and value pairs set on the event subscription when the event was made, passed through so your endpoint can read its own settings.

data?

The object the event is about, shaped like a GET of that object (an order for order:created, a payment for payment:completed). The event subscription's expand, show and hide apply to it. It is the object as it was when the event was made, not as it is now.

retry_count?integer

How many automatic retries have been made. Only returned with debug=true.

date_last_delivery_attempt?|

When the last delivery attempt was made. Only returned with debug=true.

Formatdate-time
date_next_delivery_attempt?|

When the next automatic attempt is planned. Only returned with debug=true, and only when an attempt is planned.

Formatdate-time
debug?|

Why the last attempt failed, such as the status code and the first 500 characters your server answered. Only returned with debug=true.

formatted?

Dates as display text. Only returned with formatted=true.

Example Request
curl -X POST 'https://api.comecero.com/api/v1/events/string/retry'
Example Response
{  "object": "event",  "url": "https://api.comecero.com/api/v1/events/1102611073847EVt7Kq2Za",  "event_id": "1102611073847EVt7Kq2Za",  "test": true,  "account_id": "AB1234",  "type": "order:created",  "event_subscription": "https://api.comecero.com/api/v1/event_subscriptions/1102610913420ES4f9QmLp",  "fingerprint": "k2P9wQ7xR4vT1nY8",  "status": "delivered",  "date_created": "2026-11-07T14:32:10Z",  "date_modified": "2026-11-07T15:01:30Z",  "environment_variables": {},  "data": {    "object": "order",    "order_id": "7393-GMRFY-954",    "total": 99.95,    "currency": "USD"  }}