RecruitAffiliates.ai

Create a list

A list with the same name (any case) already on the brand is returned as it is, with 200 instead of 201.

Scope: finder:write

post/v1/finder/lists

Request

  • Base URL: https://api.affiliaterail.com
  • URL: https://api.affiliaterail.com/v1/finder/lists
  • Auth: HTTP bearer

Request body

brand_idstring

Which brand. Defaults to the organization's oldest.

namestring required

Example request

{
  "brand_id": "fbr_7uSyy9FqVLCFWrdPeZaK"
}

Response

The list that already had that name

idstring required

Prefixed id (fls_…)

object'finder_list' required
brand_idstring required

Prefixed id (fbr_…)

namestring required
colourstring nullable required
countinteger required

Saved, visible prospects on the list

created_atstring date-time required

ISO-8601, UTC

Example response

{
  "id": "fls_7uSyy9FqVLCFWrdPeZaK",
  "brand_id": "fbr_7uSyy9FqVLCFWrdPeZaK",
  "created_at": "2026-08-21T10:15:30.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.