WaitlistEntry
WaitlistEntry in the Paycux API: the endpoints, the fields they accept and return, and a working request in three languages.
Overview
The WaitlistEntry resource is part of the Paycux API. Every field below is returned on every representation of the object, so you can rely on its shape across list, read and write calls.
| Field | Type | Notes |
|---|---|---|
| id | string | Stable identifier, prefixed per resource type. |
| object | string | The resource name, useful when handling webhook payloads. |
| created_at | timestamp | ISO 8601, always UTC. |
| updated_at | timestamp | ISO 8601, always UTC. |
Endpoints
Every endpoint is authenticated with a bearer token and scoped to the environment the key belongs to.
| Method | Path | What it does |
|---|---|---|
| GET | /user_management/waitlists | List waitlists |
| GET | /user_management/waitlists/:id | Get a waitlist |
| GET | /user_management/waitlists/:id/entries | List waitlist entries |
| GET | /user_management/waitlist_entries/:id/approve | Approve a waitlist entry |
| GET | /user_management/waitlist_entries/:id/deny | Deny a waitlist entry |
| DELETE | /user_management/waitlist_entries/:id | Delete a waitlist entry |
List waitlists
GET /user_management/waitlists — list waitlists.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.list_waitlists();6console.log(result);
Get a waitlist
GET /user_management/waitlists/:id — get a waitlist.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.get_a_waitlist();6console.log(result);
List waitlist entries
GET /user_management/waitlists/:id/entries — list waitlist entries.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.list_waitlist_entries();6console.log(result);
Approve a waitlist entry
GET /user_management/waitlist_entries/:id/approve — approve a waitlist entry.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.approve_a_waitlist_entry();6console.log(result);
Deny a waitlist entry
GET /user_management/waitlist_entries/:id/deny — deny a waitlist entry.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.deny_a_waitlist_entry();6console.log(result);
Delete a waitlist entry
DELETE /user_management/waitlist_entries/:id — delete a waitlist entry.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.delete_a_waitlist_entry();6console.log(result);
Errors
Errors return a JSON body with a machine-readable code, a human-readable message and, for validation failures, the offending field.
| Status | Code | Meaning |
|---|---|---|
| 400 | invalid_request | A required field is missing or malformed. |
| 401 | unauthorized | The API key is missing, revoked, or from another environment. |
| 404 | not_found | No record with that ID in this environment. |
| 429 | rate_limit_exceeded | Back off and retry after the interval in Retry-After. |