Skip to main content

Registration & Authentication

Create an Account​

Register a new account at app.pickpad.ai or via the API.

POST /account/register​

{
  "email": "merchant@example.com",
  "password": "your-password"
}

Response:

{
  "success": true,
  "access_token": "eyJhbGciOiJIUzI1NiIs..."
}

The access_token is a JWT used for all authenticated requests.

Login​

POST /account/login​

{
  "email": "merchant@example.com",
  "password": "your-password"
}

Response:

{
  "success": true,
  "access_token": "eyJhbGciOiJIUzI1NiIs..."
}

Authentication​

All authenticated endpoints require a Bearer token in the Authorization header:

Authorization: Bearer <access_token>

API Keys​

For webhook integrations, you authenticate with an API key instead of a JWT token.

Creating an API Key​

  1. Log in to the Pickpad Dashboard
  2. Go to Settings > select Webhooks as your order source
  3. API keys section will appear — click Create API Key
  4. Copy the key and store it securely

Using an API Key​

Pass the API key in the x-api-key header:

x-api-key: <your-api-key>

API keys are used exclusively for the POST /distribution/webhook/generic endpoint.