Connect Paddle

POST https://datafa.st/api/v1/admin/websites/{websiteId}/integrations/paddle

Connect Paddle with an API key. Production keys must start with pdl_live_. Sandbox keys only work in development environments.

Request

Path parameters

websiteId

string

Website ObjectId. From List websites (_id field). Example: 665f0b3c4d2e1a0012345678.

Body parameters

paddleApiKey

string

required

Paddle API key. Production: must start with pdl_live_. Sandbox keys only work in development.

Example request body

{
  "paddleApiKey": "pdl_live_..."
}

Response

Returns a JSON object with status: "success" and endpoint-specific fields in data.

Response fields

data[].message

string

Human-readable confirmation or status message for the operation.

data[].currency

string

Currency code for money values, such as USD or EUR.

Authentication

Use a dft_ account token with settings:write.

A df_ website API key for the same website can also call this route when the path websiteId matches the key's website. Write access with a df_ key is capped at member level — owner-only actions such as team management require a dft_ token and owner role.

Errors

400 — Invalid Paddle API key format.

See API errors for the standard error envelope, auth failures, validation errors, permission errors, and rate limits.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown

curl -X POST "https://datafa.st/api/v1/admin/websites/{websiteId}/integrations/paddle" \ -H "Authorization: Bearer dft_xxx" \ -H "Content-Type: application/json" \ -d '{"paddleApiKey":"pdl_live_..."}'