Public documentation and examples for the webhooks your Trebu app sends to client endpoints.
\nπ Authentication
\nDefault header: Authorization: Api-Key REPLACE_ME
Content-Type: application/json
β±οΈ Timeouts & Retries
\nTrebu times out requests after 30 seconds.
\nRetries up to 3 times on network errors/timeouts with exponential backoff (β2s β 4s β 8s).
\nβ Receiver Expectations
\nRespond with HTTP 2xx as quickly as possible (ideally < 5s).
\nPrefer JSON body with success status: { \"success\": true }.
NonβJSON is accepted but discouraged; Trebu will capture status and first 200 chars of text.
\nThis collection demonstrates Trebu's webhook event envelope and sample events for logistics tendering.
Use these requests to validate your endpoint and to learn the payload shapes you will receive in production.
Sends realistic webhook payloads to your {{callback_url}} with Authorization: Api-Key {{api_key}}.
Uses a consistent envelope: { \"event\", \"data\" }.
Implements a minimal viable set of domain events for tendering: load auctions, loads, and bid requests.
\nProvides schema fields designed to be forward-compatible: version, schema_version, occurred_at, aggregate, related, payload.
Each Trebu client can register one webhook callback URL at a time. This ensures consistent ordering and simplifies operational controls (retries, backoff, dead-letter handling).
\nIf you attempt to set a different callback URL while one already exists, Trebu will replace the previous URL (or reject the change if your tenant enforces admin-only changes).
\nAll events for that client will be delivered to the single configured URL.
\nFor multi-environment setups (e.g., staging vs prod), create separate clients and configure a callback URL per client.
\nRecommended documentation snippet you can show to your integrators:
\n\n\nWebhook callback URL
\n
Trebu delivers all webhook events for your client to a single HTTPS endpoint. Configure this under Settings β Webhooks. If you need multiple destinations, relay events from your endpoint to downstream services. To change the URL, update it in settings; the previous URL will stop receiving events immediately after the change is saved.
HTTP header: Authorization: Api-Key
Keep your API key secret; rotate regularly.
\nOptionally, enable IP allowlists and (future) message signatures.
\nDelivery is at-least-once.
\nDeduplicate by data.id.
Respond quickly (β€3s). Use asynchronous processing on your side.
\nversion β semantic event versioning (business meaning)
schema_version β JSON structure version (MVP: 1)
Set {{callback_url}} to your public HTTPS receiver (e.g., ngrok).
Set {{api_key}} to your Trebu API key.
Send sample events from each folder to validate parsing and auth.
\nβ
Live β Currently available in production
π§ͺ WIP β Work in progress, not yet available in production
βοΈ Planned β Designed but not yet scheduled for release
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When a new load auction (tender batch) is created and made visible to Trebu.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"load_auction.created\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When all posted loads have been awarded or no further carrier options are available.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"load_auction.options_exhausted\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When the auction opens a load to a specific carrier or assigns it contextually (MVP semantics).
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"load_auction.carrier_assigned\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: β Live
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When a load (shipment) is created in Trebu with origin/destination and schedule details.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"load.created\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
Whenever non-breaking updates are made to a load (e.g., time changes).
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"load.updated\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: β Live
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When a load (shipment) is created in Trebu with origin/destination and schedule details.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\nDelivery is at-least-once (duplicates are possible).
\nRecommended: treat webhooks as notifications and fetch current state via API, or apply client-side dedupe using a content fingerprint (e.g., SHA256 of {event, aggregate.id, occurred_at, payload}).
Schema
Root envelope:
{ \"event\": \"truck_availability.created\", \"data\": { ... } }\n\nCore fields inside data:
id β unique event id
version β event semantic version
schema_version β JSON schema structure version (MVP: 1)
occurred_at β RFC 3339 timestamp
aggregate β primary entity for ordering and context
related β cross-links to other ids (load, carrier, auction, etc.)
payload β event-specific content (see sample body)
Retries & Signatures (MVP)
\nTrebu will retry on non-2xx responses with exponential backoff (configurable in production).
\n(Optional) HMAC signatures may be added in a later version for body integrity.
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When a bid request is created for a carrier for a specific load.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"bid_request.created\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When a carrier asks the shipper a question about a bid request.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"bid_request.question_asked\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When a carrier proposes a rate for a bid request.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"bid_request.rate_proposed\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Pricing fields
\npayload.currency β ISO currency code (e.g., MXN).payload.rate β Monetary amount as string.payload.rate_type β Kind of rate quoted. Allowed: all_in (default), linehaul_only, fuel_inclusive, other.Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When the carriers accepts to do a load or indicates availability to move the load.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\nDelivery is at-least-once (duplicates are possible).
\nRecommended: treat webhooks as notifications and fetch current state via API, or apply client-side dedupe using a content fingerprint (e.g., SHA256 of {event, aggregate.id, occurred_at, payload}).
Schema
Root envelope:
{ \"event\": \"bid_request.accepted\", \"data\": { ... } }\n\nCore fields inside data:
id β unique event id
version β event semantic version
schema_version β JSON schema structure version (MVP: 1)
occurred_at β RFC 3339 timestamp
aggregate β primary entity for ordering and context
related β cross-links to other ids (load, carrier, auction, etc.)
payload β event-specific content (see sample body)
Retries & Signatures (MVP)
\nTrebu will retry on non-2xx responses with exponential backoff (configurable in production).
\n(Optional) HMAC signatures may be added in a later version for body integrity.
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When a load that has been accepted by the carrier is confirmed and assigned to said carrier.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\nDelivery is at-least-once (duplicates are possible).
\nRecommended: treat webhooks as notifications and fetch current state via API, or apply client-side dedupe using a content fingerprint (e.g., SHA256 of {event, aggregate.id, occurred_at, payload}).
Schema
Root envelope:
{ \"event\": \"bid_request.confirmed\", \"data\": { ... } }\n\nCore fields inside data:
id β unique event id
version β event semantic version
schema_version β JSON schema structure version (MVP: 1)
occurred_at β RFC 3339 timestamp
aggregate β primary entity for ordering and context
related β cross-links to other ids (load, carrier, auction, etc.)
payload β event-specific content (see sample body)
Retries & Signatures (MVP)
\nTrebu will retry on non-2xx responses with exponential backoff (configurable in production).
\n(Optional) HMAC signatures may be added in a later version for body integrity.
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: π§ͺ WIP
\nPurpose
This webhook informs your system about the following event in the Trebu tendering flow.
When it's sent
When the shipper rejects a carrier's bid request or offer.
Authentication
Include Authorization: Bearer {api_key} in the request headers.
Delivery
\n{event, aggregate.id, occurred_at, payload}).Schema
Root envelope:
{ \"event\": \"bid_request.rejected\", \"data\": { ... } }\nCore fields inside data:
id β unique event idversion β event semantic versionschema_version β JSON schema structure version (MVP: 1)occurred_at β RFC 3339 timestampaggregate β primary entity for ordering and contextrelated β cross-links to other ids (load, carrier, auction, etc.)payload β event-specific content (see sample body)Retries & Signatures (MVP)
\nResponse
Return HTTP 200 as quickly as possible. If you need to do heavy work, enqueue internally and return immediately.
Status: β Live
\nTriggered when a carrier accepts a trip offer via WhatsApp.
\nUse this to auto-confirm or notify your team. The carrier_id can be used with POST /tendering/{trip_id}/confirm/ to confirm the carrier.
Status: β Live
\nTriggered when a carrier declines a trip offer via WhatsApp.
\n","urlObject":{"host":["{{callback_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"5b673dd8-cfd4-426e-8e6e-0a96b9471bac"},{"name":"β [Live] fmt.carrier_question","id":"bac27603-dbd2-425d-bc82-df80a707ef6e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Api-Key {{api_key}}"},{"key":"X-Webhook-Event","value":"fmt.carrier_question"},{"key":"X-Webhook-Timestamp","value":"1782224119"}],"body":{"mode":"raw","raw":"{\n \"event\": \"fmt.carrier_question\",\n \"timestamp\": \"2026-04-24T10:00:00Z\",\n \"data\": {\n \"trip_id\": 12345,\n \"shipment_number\": \"SHP-2026-001\",\n \"folio_number\": \"F-001\",\n \"origin\": {\"city\": \"Mexico City\", \"state\": \"CDMX\"},\n \"destination\": {\"city\": \"Guadalajara\", \"state\": \"Jalisco\"},\n \"loading_date\": \"2026-05-01\",\n \"unit_type\": \"Caja 53ft\",\n \"carrier\": {\n \"carrier_id\": 104,\n \"carrier_name\": \"Reliable Freight\",\n \"channel_id\": null,\n \"phone\": \"+525598761234\"\n },\n \"question\": \"ΒΏRequiere escolta?\",\n \"asked_at\": \"2026-04-24T10:00:00Z\"\n }\n}"},"url":"{{callback_url}}","description":"Status: β Live
\nTriggered when a carrier asks a question about a trip via WhatsApp.
\nRespond using POST /tendering/{trip_id}/answer/ with the carrier_id and your answer text.
Status: β Live
\nTriggered when a carrier is confirmed for a trip, either via API or manually in the UI.
\n","urlObject":{"host":["{{callback_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fad95e3f-c1d3-4f0d-85d7-f0bf9b89b34f"},{"name":"β [Live] fmt.trip_unconfirmed","id":"fa9ce7be-cb77-482c-a292-5a9946f5646a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Api-Key {{api_key}}"},{"key":"X-Webhook-Event","value":"fmt.trip_unconfirmed"},{"key":"X-Webhook-Timestamp","value":"1782224119"}],"body":{"mode":"raw","raw":"{\n \"event\": \"fmt.trip_unconfirmed\",\n \"timestamp\": \"2026-04-24T15:00:00Z\",\n \"data\": {\n \"trip_id\": 12345,\n \"shipment_number\": \"SHP-2026-001\",\n \"folio_number\": \"F-001\",\n \"external_load_id\": \"SYS-LOAD-98765\",\n \"origin\": {\"city\": \"Mexico City\", \"state\": \"CDMX\"},\n \"destination\": {\"city\": \"Guadalajara\", \"state\": \"Jalisco\"},\n \"loading_date\": \"2026-05-01\",\n \"unit_type\": \"Caja 53ft\",\n \"previous_carrier\": {\n \"carrier_id\": 101,\n \"carrier_name\": \"Transportes del Norte\",\n \"channel_id\": null,\n \"phone\": \"+525512345678\"\n },\n \"reason\": \"Carrier requested schedule change\",\n \"unconfirmed_at\": \"2026-04-24T15:00:00Z\",\n \"unconfirmed_by\": \"user@company.com\"\n }\n}"},"url":"{{callback_url}}","description":"Status: β Live
\nTriggered when a previously confirmed carrier is unconfirmed (trip reassignment).
\n","urlObject":{"host":["{{callback_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"fa9ce7be-cb77-482c-a292-5a9946f5646a"},{"name":"β [Live] fmt.tendering_exhausted","id":"6b51db10-c4c5-4c9a-b633-4c88b7116f1f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Api-Key {{api_key}}"},{"key":"X-Webhook-Event","value":"fmt.tendering_exhausted"},{"key":"X-Webhook-Timestamp","value":"1782224119"}],"body":{"mode":"raw","raw":"{\n \"event\": \"fmt.tendering_exhausted\",\n \"timestamp\": \"2026-04-24T18:00:00Z\",\n \"data\": {\n \"trip_id\": 12345,\n \"shipment_number\": \"SHP-2026-001\",\n \"folio_number\": \"F-001\",\n \"origin\": {\"city\": \"Mexico City\", \"state\": \"CDMX\"},\n \"destination\": {\"city\": \"Monterrey\", \"state\": \"Nuevo LeΓ³n\"},\n \"loading_date\": \"2026-05-01\",\n \"unit_type\": \"Caja 53ft\",\n \"total_carriers_contacted\": 15,\n \"total_rejected\": 12,\n \"total_no_response\": 3,\n \"exhausted_at\": \"2026-04-24T18:00:00Z\",\n \"message\": \"All available carriers have been contacted. Consider adjusting trip parameters.\"\n }\n}"},"url":"{{callback_url}}","description":"Status: β Live
\nTriggered when all carriers have been contacted and none have accepted. Trip status becomes no_carriers.
Status: β Live
\nTriggered when the tendering process is cancelled via API or UI.
\n","urlObject":{"host":["{{callback_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"8d4ea9b2-e77e-4ad4-a6c6-bae512161985"},{"name":"β [Live] fmt.trip_created","id":"f89559a8-18d6-45ab-a5d2-94febc42699b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Api-Key {{api_key}}"},{"key":"X-Webhook-Event","value":"fmt.trip_created"},{"key":"X-Webhook-Timestamp","value":"1782224119"}],"body":{"mode":"raw","raw":"{\n \"event\": \"fmt.trip_created\",\n \"timestamp\": \"2026-04-24T08:00:00Z\",\n \"data\": {\n \"trip_id\": 12345,\n \"external_load_id\": \"SYS-LOAD-98765\",\n \"origin\": {\"city\": \"Mexico City\", \"state\": \"CDMX\", \"country\": \"MX\"},\n \"destination\": {\"city\": \"Guadalajara\", \"state\": \"Jalisco\", \"country\": \"MX\"},\n \"loading_datetime\": \"2026-05-01T08:00:00Z\",\n \"unit_type\": \"Caja 53ft\",\n \"created_at\": \"2026-04-24T08:00:00Z\"\n }\n}"},"url":"{{callback_url}}","description":"Status: β Live
\nTriggered when a trip is successfully created via the tendering API.
\n","urlObject":{"host":["{{callback_url}}"],"query":[],"variable":[]}},"response":[],"_postman_id":"f89559a8-18d6-45ab-a5d2-94febc42699b"},{"name":"β [Live] fmt.tendering_started","id":"6566493e-5fe2-4bf4-af8d-034cb56c7d91","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Api-Key {{api_key}}"},{"key":"X-Webhook-Event","value":"fmt.tendering_started"},{"key":"X-Webhook-Timestamp","value":"1782224119"}],"body":{"mode":"raw","raw":"{\n \"event\": \"fmt.tendering_started\",\n \"timestamp\": \"2026-04-24T08:01:00Z\",\n \"data\": {\n \"trip_id\": 12345,\n \"external_load_id\": \"SYS-LOAD-98765\",\n \"origin\": {\"city\": \"Mexico City\", \"state\": \"CDMX\"},\n \"destination\": {\"city\": \"Guadalajara\", \"state\": \"Jalisco\"},\n \"loading_date\": \"2026-05-01\",\n \"unit_type\": \"Caja 53ft\",\n \"carriers_contacted\": 8,\n \"carriers\": [\n {\"carrier_id\": 101, \"carrier_name\": \"Transportes del Norte\", \"channel_id\": null, \"phone\": \"+525512345678\"}\n ],\n \"started_at\": \"2026-04-24T08:01:00Z\"\n }\n}"},"url":"{{callback_url}}","description":"Status: β Live
\nTriggered when carriers are first notified about a trip. Useful when no candidate_carriers were provided and carrier discovery happened asynchronously β carriers_contacted here has the final count.
Webhook events fired by the FMT (Find Me a Truck) tendering system. All fmt.* events include X-Webhook-Event and X-Webhook-Timestamp headers.
Events Trebu sends to your system. Use these to simulate incoming webhooks to your {{callback_url}}.
Status: π§ͺ WIP
\nPurpose\nSet or replace the single webhook callback URL for your client. All outbound events will be delivered to this URL.
\nSingle URL rule\nEach client can have one active callback URL. Setting a new URL replaces the previous destination immediately.
\nHeaders
\nAuthorization: Bearer {{api_key}}{\n \"callback_url\": \"https://example.com/trebu-hooks\",\n \"updated_at\": \"2025-11-12T17:12:03Z\"\n}\nStatus: π§ͺ WIP
\nReturns the configured webhook callback URL for this client.
\nResponse (200)
\n{\n \"callback_url\": \"https://example.com/trebu-hooks\"\n}\nManage your single callback URL via API.
\n","_postman_id":"747ecd06-e994-4dd4-8f78-87539544f46a"},{"name":"Bid Requests","item":[{"name":"π§ͺ [WIP] Reply to carrier question","id":"cf81c692-fe55-4720-80a5-e6680aa3a2e4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Api-Key {{api_key}}"}],"body":{"mode":"raw","raw":"{\n \"text\": \"Yes, live unload is required.\"\n}"},"url":"https://api.trebu.io/api/v1/bid_requests/{{bid_request_id}}/questions/{{question_id}}/reply","description":"Status: π§ͺ WIP
\nPurpose\nPost an official answer to a question a carrier asked on a bid request.
\nPath params
\nbid_request_idquestion_idBody
\n{\n \"text\": \"Yes, live unload is required.\"\n}\nResult
\nbid_request.question_answered) in a future iteration.Interact with bid requests (e.g., reply to carrier questions).
\n","_postman_id":"b6dc5817-49a0-46d3-9890-aa27dcf9f295"},{"name":"Loads & Auctions","item":[{"name":"π§ͺ [WIP] Start auction for a load","id":"4f76122a-b15f-43ff-a1d3-e7420cfff598","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Authorization","value":"Api-Key {{api_key}}"}],"body":{"mode":"raw","raw":"{}"},"url":"https://api.trebu.io/api/v1/loads/{{load_id}}/auction-start","description":"Status: π§ͺ WIP
\nPurpose\nCreate and open a load auction using only the load_id path parameter.
Path param
\nload_idBody (optional fields)
\n{\n \"deadline_at\": \"2025-11-12T23:00:00Z\",\n \"timezone\": \"America/Monterrey\",\n \"note\": \"MVP tender for dedicated lane\"\n}\nResponse (201)
\n{\n \"load_auction_id\": \"load_auction_7\",\n \"opened_at\": \"2025-11-11T17:01:00Z\"\n}\nSide effects
\nload_auction.created (and later, carrier_assigned, etc.).Start auctions for specific loads and manage tendering lifecycle.
\n","_postman_id":"4f0c3f18-91f3-40ff-8cd4-3c3f31fdd01d"},{"name":"Facilities","item":[{"name":"β [Live] Add or Update Facility","id":"d1d329d3-eae4-4a61-88bf-3c88381fc569","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json","type":"text"},{"key":"Authorization","value":"Api-Key {{api_key}}","type":"text"}],"body":{"mode":"raw","raw":"{\n \"shipper\": \"ACME CORP S.A. de C.V.\",\n \"facility_name\": \"CEDIS ACME Bajio\",\n \"qa_facility_id\": null,\n \"facility_id\": \"6581\",\n \"country\": \"Mexico\",\n \"state\": \"Guanajuato\",\n \"city\": \"LeΓ³n de los Aldama\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.trebu.io/api/v1/update-facilities","urlObject":{"protocol":"https","path":["api","v1","update-facilities"],"host":["api","trebu","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"d1d329d3-eae4-4a61-88bf-3c88381fc569"}],"id":"360d99e6-5f28-488d-b620-c16f8b90f3d5","_postman_id":"360d99e6-5f28-488d-b620-c16f8b90f3d5","description":""},{"name":"FMT Tendering","item":[{"name":"List Trips","id":"1a81792d-cb6e-476e-90c3-139edf6b865c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.trebu.io/api/v1/client/tendering/?status=pending&limit=50&offset=0","description":"List all trips for the authenticated company. Returns paginated results.
\n","urlObject":{"protocol":"https","path":["api","v1","client","tendering",""],"host":["api","trebu","io"],"query":[{"description":{"content":"pending | awaiting_confirmation | confirmed | no_carriers | cancelled
\n","type":"text/plain"},"key":"status","value":"pending"},{"disabled":true,"description":{"content":"YYYY-MM-DD
\n","type":"text/plain"},"key":"from_date","value":"2026-01-01"},{"disabled":true,"description":{"content":"YYYY-MM-DD
\n","type":"text/plain"},"key":"to_date","value":"2026-04-24"},{"description":{"content":"Max 100
\n","type":"text/plain"},"key":"limit","value":"50"},{"key":"offset","value":"0"}],"variable":[]}},"response":[],"_postman_id":"1a81792d-cb6e-476e-90c3-139edf6b865c"},{"name":"Create Trip (Single)","event":[{"listen":"test","script":{"exec":["if (pm.response.code === 201) { var j = pm.response.json(); pm.collectionVariables.set('trip_id', j.trip_id); }"],"type":"text/javascript","id":"7eebfb60-246e-4d6a-9613-59cad999c598"}}],"id":"13df1e99-c60c-4fd2-9662-d01ad618b2d3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"external_load_id\": \"LOAD-2026-001\",\n \"folio_number\": \"FOL-2026-001\",\n \"shipper\": {\n \"name\": \"Acme Corporation\",\n \"contact\": \"John Doe\",\n \"phone\": \"+52-555-1234567\",\n \"email\": \"john@acme.com\"\n },\n \"origin\": {\n \"name\": \"Warehouse A\",\n \"address_line\": \"Calle Principal 123\",\n \"city\": \"Guadalajara\",\n \"state\": \"Jalisco\",\n \"country\": \"MX\",\n \"scheduled_datetime\": \"2026-05-01T08:00:00Z\"\n },\n \"destination\": {\n \"city\": \"Ciudad de Mexico\",\n \"state\": \"Ciudad de Mexico\",\n \"country\": \"MX\"\n },\n \"load_details\": {\n \"unit_type\": \"Caja 53ft\",\n \"weight_kg\": 15000,\n \"pallets\": 20\n },\n \"candidate_carriers\": [\n {\n \"carrier_name\": \"Fast Logistics S.A.\",\n \"contact_name\": \"Maria Garcia\",\n \"phone\": \"+52-555-9876543\",\n \"preferred_language\": \"es\"\n }\n ],\n \"options\": {\n \"broadcast_immediately\": true,\n \"rate_requested\": true,\n \"proposed_rate\": 25000,\n \"currency\": \"MXN\"\n }\n}"},"url":"https://api.trebu.io/api/v1/client/tendering/","description":"Create a single trip and optionally send it to candidate carriers.
\nUse carrier_name+contact_name (explicit) instead of the legacy name field.\nUse phone for direct chats or channel_id for group chats β mutually exclusive.
The response carriers[].carrier_id is the Trebu internal ID β store it for future calls.
Multi-stop loads: add an optional stops: [...] array to declare additional drops on the same load. See the \"Create Multi-Stop Load (Single)\" example for details. Omitting stops or sending [] is identical to a single-destination load.
Create a load with multiple delivery destinations.
\nThe load has one pickup (origin) and N drops: the load-level destination is the first drop, and each entry in stops[] is an additional drop.
Stop fields:
\ndestination (required): same shape as the load-level destination, with its own scheduled_datetime (used as unloading time).load_details (optional): per-stop overrides. Any field omitted inherits from the parent's load_details. Omit entirely to inherit everything.external_load_id (optional): if you want to track this stop separately. Stays null if omitted β never auto-generated.NOT allowed on a stop (returns 400): origin, loading_date, loading_time, shipper, candidate_carriers, options, folio_number β these are load-level only.
Limits: max 9 stops per load (10 legs total). Stops are not separately broadcast and not visible as standalone trips in GET /tendering/.
Create a trip using WhatsApp group chat carriers via channel_id. Mutually exclusive with phone.
Create up to 15 loads atomically by sending a JSON array. Stops in stops[] do NOT count toward the 15-load cap, but the total number of trips (loads + stops) cannot exceed 50. All external_load_id values β including any stop-level ones supplied β must be unique within the batch. All trips must have the same broadcast_immediately value.
Multi-stop: any load in the batch can include an optional stops: [...] array. See the \"Create Multi-Stop Batch\" example.
Batch with one multi-stop load (BATCH-MS-001 has one extra stop) and one single-destination load (BATCH-MS-002). Demonstrates that multi-stop and single-stop loads can be mixed freely in the same batch.
\nThe response's per-load entry includes a stops array (empty for loads without additional stops).
Get full trip details including all carrier responses (carrier_id, status, rate, question, etc.).
Confirm a carrier for a trip. The carrier must have status: accepted. Triggers a confirmation message to the carrier.
Answer a carrier's question about a trip. The answer is sent to the carrier via WhatsApp.
\n","urlObject":{"protocol":"https","path":["api","v1","client","tendering","{{trip_id}}","answer",""],"host":["api","trebu","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"0879e534-a689-4168-a475-24c73ab9e934"},{"name":"Cancel Tendering","id":"0a7d6d8d-3d7f-4777-a56a-790c0dc91ffd","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"reason\": \"Trip cancelled by client\"\n}"},"url":"https://api.trebu.io/api/v1/client/tendering/{{trip_id}}/cancel/","description":"Cancel the tendering process for a trip. All contacted carriers are notified. reason is optional.
CSV or Excel file (.csv, .xlsx, .xls)
\n","value":null},{"key":"broadcast_immediately","value":"true","type":"text","description":"Optional, default true
\n"},{"key":"sheet_name","value":"Trips","type":"text","description":"Optional: Excel sheet name
\n","disabled":true}]},"url":"https://api.trebu.io/api/v1/client/tendering/upload/","description":"Upload a CSV or Excel file to create multiple trips at once. Duplicate files (by content hash) are rejected with 409.
\n","urlObject":{"protocol":"https","path":["api","v1","client","tendering","upload",""],"host":["api","trebu","io"],"query":[],"variable":[]}},"response":[],"_postman_id":"b53d71d8-95f7-4afb-8920-cca22dfe64f1"}],"id":"09a1b525-f993-4c8d-b48e-bd52d8641020","description":"FMT (Find Me a Truck) tendering API. Base path: /api/v1/client/tendering/
\nAuthentication is inherited from the collection (Api-Key header).
\nSet the trip_id and carrier_id collection variables after creating a trip to use the action endpoints.
Endpoints you call to interact with Trebu (manage webhooks, reply to questions, start auctions, tendering API).
\n","_postman_id":"f04223f6-98a6-484f-9584-2b983e53d100"}],"id":"698b1184-12c4-4af0-88f5-63c626c1212f","description":"Current API & Webhooks (MVP). Backwards-compatible additions will land here. Breaking changes will go to v2+.
\n","_postman_id":"698b1184-12c4-4af0-88f5-63c626c1212f"}],"variable":[{"key":"receiver_url","value":"https://example.com/webhooks/trebu"},{"key":"api_key_or_token","value":"REPLACE_ME"}]}