AuthKit
AuthKit in the Paycux API: the endpoints, the fields they accept and return, and a working request in three languages.
Overview
The AuthKit 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 |
|---|---|---|
| POST | /user_management/cors_origins | Create a CORS origin |
| POST | /user_management/users/:user_id/connected_accounts/:slug | Import a connected account |
| POST | /user_management/radar_challenges | Send a Radar SMS challenge |
| GET | /user_management/radar_challenges/:id | Get Radar Challenge details |
Create a CORS origin
POST /user_management/cors_origins — create a CORS origin.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.create_a_cors_origin();6console.log(result);
Import a connected account
POST /user_management/users/:user_id/connected_accounts/:slug — import a connected account.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.import_a_connected_account();6console.log(result);
Send a Radar SMS challenge
POST /user_management/radar_challenges — send a Radar SMS challenge.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.send_a_radar_sms_challenge();6console.log(result);
Get Radar Challenge details
GET /user_management/radar_challenges/:id — get Radar Challenge details.
1import Paycux from '@paycux/node';23const paycux = new Paycux(process.env.PAYCUX_API_KEY);45const result = await paycux.get_radar_challenge_details();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. |