Connect Suppliers

Connecting a supplier enables mapping.travel to run ID-to-ID mappings between your hotel inventory and that supplier’s dataset. Your billing plan grants a permanent budget of distinct suppliers your organization may ever connect: connecting a new supplier consumes one unit of that budget, disconnecting does not restore it, and reconnecting a supplier you have used before is free. Disconnecting removes the active connection but does not delete historical mapping results.

Both endpoints require authentication. Include your API key in the X-API-Key header for all requests.

POST /api/v1/suppliers//connect

Connect your organization to a supplier.

POST https://api.mapping.travel/api/v1/suppliers/{supplierId}/connect

Path parameters

string

required

UUID of the supplier to connect. Retrieve supplier IDs from GET /api/v1/suppliers.

Response

Returns 201 Created with the supplier connection details.

string

required

UUID of the connected supplier.

string

required

Short code of the connected supplier (e.g. expedia).

string

required

Display name of the connected supplier.

string

Short description of the supplier, if available.

string

URL of the supplier logo image, if available.

string

required

ISO 8601 timestamp of when the connection was created.

Errors

Status	Description
`409 Conflict`	You are already connected to this supplier, or connecting it would exceed your plan’s permanent budget of distinct suppliers.
`404 Not Found`	No supplier exists with the given ID.

Example

curl -X POST \
  "https://api.mapping.travel/api/v1/suppliers/a1b2c3d4-0000-0000-0000-000000000001/connect" \
  -H "X-API-Key: <token>"

{
  "id": "a1b2c3d4-0000-0000-0000-000000000001",
  "code": "expedia",
  "name": "Expedia",
  "description": "Global online travel marketplace",
  "logoUrl": "https://cdn.mapping.travel/logos/expedia.png",
  "connectedAt": "2026-04-25T10:30:00Z"
}

Check your remaining supplier budget before connecting. GET /api/v1/suppliers/my-suppliers returns a rateLimitRemaining field with the number of new distinct suppliers you can still connect on your plan.

DELETE /api/v1/suppliers//disconnect

Disconnect your organization from a supplier.

DELETE https://api.mapping.travel/api/v1/suppliers/{supplierId}/disconnect

Path parameters

string

required

UUID of the supplier to disconnect.

Response

Returns 204 No Content on success. The response body is empty.

Errors

Status	Description
`404 Not Found`	Your organization is not connected to the specified supplier.

Example

curl -X DELETE \
  "https://api.mapping.travel/api/v1/suppliers/a1b2c3d4-0000-0000-0000-000000000001/disconnect" \
  -H "X-API-Key: <token>"

Inventory

Mapping

Reference Hotels

Suppliers

Webhooks

Export

POST /api/v1/suppliers//connect

Path parameters

Response

Errors

Example

DELETE /api/v1/suppliers//disconnect

Path parameters

Response

Errors

Example

​POST /api/v1/suppliers//connect

​Path parameters

​Response

​Errors

​Example

​DELETE /api/v1/suppliers//disconnect

​Path parameters

​Response

​Errors

​Example

POST /api/v1/suppliers//connect

Path parameters

Response

Errors

Example

DELETE /api/v1/suppliers//disconnect

Path parameters

Response

Errors

Example