Skip to main content

Registration & Authentication

Create an Account​

You can sign up at app.pickpad.ai, or register through the API if you're integrating directly.

POST /account/register​

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

Response:

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

The access_token you get back is a JWT — hang onto it, since you'll need it for every authenticated request.

Login​

POST /account/login​

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

Response:

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

Authentication​

Every authenticated endpoint expects a Bearer token in the Authorization header:

Authorization: Bearer <access_token>

API Keys​

Webhook integrations work a little differently — instead of a JWT, you authenticate with an API key.

Creating an API Key​

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

Using an API Key​

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

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

API keys only work with the POST /distribution/webhook/generic endpoint — they won't authenticate anything else.