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

# Pool merchants — add and remove

> Add or remove merchants from a pool.

<Note>
  Merchant IDs here are the **bare** ID — no `nmer_`/`mer_` prefix, matching the form pool
  responses return in `included_merchants[].id`/`excluded_merchants[].id`. This differs from the
  prefixed IDs `GET /v1/merchants` returns.
</Note>

## Add merchants to pool

**`POST /v1/pools/{id}/merchants`**

<ParamField body="merchant_ids" type="string[]" required>
  Array of merchant IDs to add.
</ParamField>

```json theme={null}
{
  "merchant_ids": ["MERCHANT_ID_1", "MERCHANT_ID_2"]
}
```

***

## Remove merchants from pool

**`DELETE /v1/pools/{id}/merchants`**

<ParamField body="merchant_ids" type="string[]" required>
  Array of merchant IDs to remove.
</ParamField>

```json theme={null}
{
  "merchant_ids": ["MERCHANT_ID_1"]
}
```