> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapping.travel/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect and disconnect your organization from suppliers

> Add or remove supplier connections for your organization. Your plan's supplier limit controls how many active connections you can maintain at one time.

Connecting a supplier enables Mapping.Travel to run ID-to-ID mappings between your hotel inventory and that supplier's dataset. Your current billing plan determines the maximum number of suppliers you can connect simultaneously. Disconnecting removes the active connection but does not delete historical mapping results.

<Warning>
  Both endpoints require authentication. Include your bearer token in the `Authorization` header for all requests.
</Warning>

***

## POST /api/v1/suppliers/{supplierId}/connect

Connect your organization to a supplier.

```bash theme={null} theme={null}
POST https://api.mapping.travel/api/v1/suppliers/{supplierId}/connect
```

### Path parameters

<ParamField path="supplierId" type="string" required>
  UUID of the supplier to connect. Retrieve supplier IDs from `GET /api/v1/suppliers`.
</ParamField>

### Response

Returns `201 Created` with the supplier connection details.

<ResponseField name="id" type="string" required>
  UUID of the newly created connection.
</ResponseField>

<ResponseField name="supplierId" type="string" required>
  UUID of the connected supplier.
</ResponseField>

<ResponseField name="supplierCode" type="string" required>
  Short code of the connected supplier.
</ResponseField>

<ResponseField name="supplierName" type="string" required>
  Display name of the connected supplier.
</ResponseField>

<ResponseField name="connectedAt" type="string" required>
  ISO 8601 timestamp of when the connection was created.
</ResponseField>

### Errors

| Status            | Description                                                                        |
| ----------------- | ---------------------------------------------------------------------------------- |
| `400 Bad Request` | Your plan's maximum supplier limit has been reached, or you have hit a rate limit. |
| `404 Not Found`   | No supplier exists with the given ID.                                              |

### Example

```bash theme={null} theme={null}
curl -X POST \
  "https://api.mapping.travel/api/v1/suppliers/a1b2c3d4-0000-0000-0000-000000000001/connect" \
  -H "Authorization: Bearer <token>"
```

```json theme={null} theme={null}
{
  "id": "conn-5f6a7b8c-0000-0000-0000-000000000001",
  "supplierId": "a1b2c3d4-0000-0000-0000-000000000001",
  "supplierCode": "expedia",
  "supplierName": "Expedia",
  "connectedAt": "2026-04-25T10:30:00Z"
}
```

<Tip>
  Check your current plan limits before connecting suppliers. Use `GET /api/v1/billing/quota/status` to see your `maxSuppliers` value and how many you have already connected.
</Tip>

***

## DELETE /api/v1/suppliers/{supplierId}/disconnect

Disconnect your organization from a supplier.

```bash theme={null} theme={null}
DELETE https://api.mapping.travel/api/v1/suppliers/{supplierId}/disconnect
```

### Path parameters

<ParamField path="supplierId" type="string" required>
  UUID of the supplier to disconnect.
</ParamField>

### Response

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

### Errors

| Status            | Description                                                   |
| ----------------- | ------------------------------------------------------------- |
| `400 Bad Request` | Rate limit exceeded.                                          |
| `404 Not Found`   | Your organization is not connected to the specified supplier. |

### Example

```bash theme={null} theme={null}
curl -X DELETE \
  "https://api.mapping.travel/api/v1/suppliers/a1b2c3d4-0000-0000-0000-000000000001/disconnect" \
  -H "Authorization: Bearer <token>"
```