Store
Sales from other systems
If your sales close in another system (your CRM, point of sale or ERP), send them here. Recaudo finds the customer, ties the sale to the ad that brought them and tells Meta how much you sold, so the campaign looks for more people who buy and not just people who write.
Record a sale
POST
/v1/sales
Call it when the sale closes. Sending it again with the same external_id updates it; it is never duplicated.
| Field | Description |
|---|---|
| external_id * | The sale id in your system. Unique per business; it is what prevents counting it twice. |
| amount * | Total sale amount, with decimals. |
| currency | ISO 4217 currency. Defaults to your business currency. |
| sold_at | Sale date and time in ISO 8601. Defaults to now. |
| status | completed (default) or cancelled to void a sale you already sent. |
| description | What was sold, free text. |
| customer | Who bought: id, external_id, email, phone and name. A phone or email is enough. |
| conversation_id | The Recaudo conversation, if your system knows it. It wins over the customer lookup. |
| ad_id | The Meta ad id, if your system knows it. |
| metadata | Extra data from your system. Returned as is. |
Request
curl -X POST "https://recaudo.app/api/v1/sales" \
-H "Authorization: Bearer sk_live_tu_secret_key" \
-H "Content-Type: application/json" \
-d '{
"external_id": "CRM-1001",
"amount": 33012.00,
"currency": "MXN",
"sold_at": "2026-11-20T12:30:00-06:00",
"description": "Plan anual",
"customer": {
"phone": "+52 55 1234 5678",
"email": "cliente@ejemplo.com",
"name": "Ana López"
}
}'
Response
{
"object": "sale",
"id": "9a7c1e2b-4d3f-4a1b-9c8d-7e6f5a4b3c2d",
"external_id": "CRM-1001",
"order_number": "ORD-2026-000184",
"amount": 33012.0,
"currency": "MXN",
"status": "completed",
"sold_at": "2026-11-20T12:30:00-06:00",
"description": "Plan anual",
"customer": {
"id": "5b1f0c3e-2a4d-4e6f-8b9a-0c1d2e3f4a5b",
"name": "Ana López",
"matched_by": "phone"
},
"attribution": {
"conversation_id": "0d9e8f7a-6b5c-4d3e-2f1a-0b9c8d7e6f5a",
"ad_id": "120251597851470124",
"ad_name": "video_plan_anual",
"campaign_id": "120250996966730124",
"campaign_name": "Mensajes WhatsApp noviembre"
},
"metadata": null,
"created_at": "2026-11-20T18:30:02+00:00",
"updated_at": "2026-11-20T18:30:02+00:00"
}
- Customer: looked up by Recaudo id, then external_id, email and phone (last 10 digits). If not found and a phone or email is given, it is created. matched_by says which field matched.
- Ad: the last ad that brought the customer in the 90 days before the sale wins. If they did not come from an ad, attribution.ad_id is empty and the sale is still saved.
- Retries: if your call fails halfway or you are not sure it arrived, send it again with the same external_id. It returns 201 the first time and 200 afterwards.
- Cancellations: send the same sale with status cancelled. It stops counting in ad reports.
- Meta: the sale is sent as Purchase with its amount to the pixel and, if the customer came from a WhatsApp ad, to that line's dataset. It is sent once per sale.
- Where it shows: in Orders (source "Other system") and in Meta Ads, where it counts toward sales, cost per sale and revenue for each ad and campaign.
Get a sale
GET
/v1/sales/{external_id}
Returns the sale by your system's id, with the customer and the ad and campaign it was attributed to.
Was this page helpful?
Thanks for letting us know.