Create a dynamic set.
POST/sets
Creates a free dynamic set owned by the authenticated user. Add candidate listings (from GET /sets/candidates) by passing their internal listing_ids in listing_ids; they are added with the active status. The set is created on the free plan — upgrade it with POST /sets/{set_id}/upgrade to access its KPI endpoints.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 429
The created dynamic set.
Validation error (e.g. name missing, or too many listing IDs).
API key authorization failed.
The API key is read-only.
One or more of the provided listing IDs were not found.
Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the Rate Limits section in the overview for the recommended exponential backoff strategy.