Manage API Keys and Webhooks programmatically

This page details the endpoints for managing API keys and webhooks programmatically. These endpoints allow you to control access to the Request Network API, and receive real-time notifications about important events.

Key Features:

• API Key Management: Create, list, toggle, and delete API keys to control access to your platform's resources. API keys are essential for authenticating your application and ensuring secure communication with the Request Network API.

• Webhook Management: Configure and manage webhooks to receive real-time notifications about events within the Request Network. This enables your application to react instantly to payment confirmations, request updates, and other critical events.

Authentication Requirement:

Most of the endpoints described in this section require an active session_token cookie. This cookie is automatically set in your browser after a successful login. Make sure you've logged in before attempting to use these endpoints.

Authentication

Register a new user

Register a new user with an email and password

post

/v1/auth/register

Body

emailstringrequired

passwordstring · min: 8 · max: 100required

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.request.network/v1/auth/register' \
  --header 'Content-Type: application/json'

201

400

429

201

No body

Successfully registered

Login user

Login with email and password

post

/v1/auth/login

Body

emailstringrequired

passwordstring · min: 8 · max: 100required

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.request.network/v1/auth/login' \
  --header 'Content-Type: application/json'

200

400

429

200

No body

Successfully logged in

Logout user (Requires Session)

Logout and clear session

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

post

/v1/auth/logout

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.request.network/v1/auth/logout' \
  --header 'Cookie: session_token=<your-session-token>'

200

401

429

200

No body

Successfully logged out

Manage API Keys

Create API key (Requires Session)

Create a new API key for your platform

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

post

/v1/key

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Body

labelstring · min: 1 · max: 100required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.request.network/v1/key' \
  --header 'Cookie: session_token=<your-session-token>' \
  --header 'Content-Type: application/json'

201

401

429

201

{
  "id": "text",
  "key": "text",
  "label": "text",
  "isActive": true,
  "createdAt": "2025-02-20T19:23:23.171Z"
}

API key created successfully

List API keys (Requires Session)

Get all API keys for your platform

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

get

/v1/key

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.request.network/v1/key' \
  --header 'Cookie: session_token=<your-session-token>'

200

401

429

200

[
  {
    "id": "text",
    "label": "text",
    "key": "text",
    "isActive": true,
    "createdAt": "2025-02-20T19:23:23.171Z"
  }
]

List of API keys

Toggle API key (Requires Session)

Enable or disable an API key

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

put

/v1/key/{id}

Path parameters

idstringrequired

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.request.network/v1/key/{id}' \
  --header 'Cookie: session_token=<your-session-token>'

200

401

404

429

200

No body

API key toggled successfully

Delete API key (Requires Session)

Permanently delete an API key

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

delete

/v1/key/{id}

Path parameters

idstringrequired

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://api.request.network/v1/key/{id}' \
  --header 'Cookie: session_token=<your-session-token>'

200

401

404

429

200

No body

API key deleted successfully

Manage Webhooks

Create webhook (Requires Session)

Create a new webhook endpoint for receiving notifications

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

post

/v1/webhook

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Body

urlstringrequired

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.request.network/v1/webhook' \
  --header 'Cookie: session_token=<your-session-token>' \
  --header 'Content-Type: application/json'

201

400

401

429

201

{
  "id": "text",
  "secret": "text"
}

Webhook created successfully

List webhooks (Requires Session)

Get all webhooks for your platform

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

get

/v1/webhook

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.request.network/v1/webhook' \
  --header 'Cookie: session_token=<your-session-token>'

200

401

429

200

[
  {
    "id": "text",
    "url": "text",
    "secret": "text",
    "isActive": true,
    "createdAt": "2025-02-20T19:23:23.171Z"
  }
]

List of webhooks

Toggle webhook (Requires Session)

Enable or disable a webhook

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

put

/v1/webhook/{webhookId}

Path parameters

webhookIdstringrequired

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.request.network/v1/webhook/{webhookId}' \
  --header 'Cookie: session_token=<your-session-token>'

200

401

404

429

200

No body

Webhook toggled successfully

Delete webhook (Requires Session)

Permanently delete a webhook

Requires session_token cookie. If you've logged in, this cookie is already set in your browser.

delete

/v1/webhook/{webhookId}

Path parameters

webhookIdstringrequired

Header parameters

Cookiestringrequired

Active session cookie (automatically included after login)

Example: session_token=<your-session-token>

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://api.request.network/v1/webhook/{webhookId}' \
  --header 'Cookie: session_token=<your-session-token>'

200

401

404

429

200

No body

Webhook deleted successfully

For detailed information on all available endpoints and their parameters, please refer to the full Request Network API Reference