Create account

curl --request POST \
  --url https://api.snappy.com/public-api/v2/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "name": "Snappy",
  "billingMethod": {
    "type": "INV",
    "amount": 100,
    "name": "Invoice 1"
  }
}
'

{
  "id": "a12bcd34",
  "name": "Snappy",
  "createdAt": "2025-12-06T09:50:38.536Z",
  "updatedAt": "2025-12-06T09:50:38.536Z",
  "companyId": "A1b2C3d4"
}

Accounts

Create account

Use this endpoint to create a new Account under your Company. Use this when you need to programmatically set up a new team, department, or budget owner with its own campaigns and billing method.

Required fields

name - display name of the Account
billingMethod - the initial billing method to attach to the Account
- billingMethod.type - currently must be INV (invoice). Other billing types (Prepay, PO, CC) must be set up via the Snappy Dashboard.
- billingMethod.amount - billing amount
- billingMethod.name - display name of the billing method

Optional parameters

companyId query parameter - Company ID (when not inferable from the API key context)
Request-Source header - source of the request

Behavior Notes

Returns 201 with the new Account details (id, name, createdAt, updatedAt, companyId) on success.
Returns 409 (409_PBLC_001) when an Account with the same name already exists in the Company.
Returns 422 (422_PBLC_001) for business-rule violations (e.g. invalid billing configuration).
Currently only invoice (INV) billing methods can be created via the API. To set up Prepay, PO, or Credit Card billing, create the Account first and then configure billing via the Snappy Dashboard.

Permissions

Requires: accounts:create

POST

accounts

Create account

curl --request POST \
  --url https://api.snappy.com/public-api/v2/accounts \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "name": "Snappy",
  "billingMethod": {
    "type": "INV",
    "amount": 100,
    "name": "Invoice 1"
  }
}
'

{
  "id": "a12bcd34",
  "name": "Snappy",
  "createdAt": "2025-12-06T09:50:38.536Z",
  "updatedAt": "2025-12-06T09:50:38.536Z",
  "companyId": "A1b2C3d4"
}

Authorizations

X-Api-Key

string

header

required

Company Level Authentication

Company level authentication provides access to all resources under your company, including accounts, campaigns, gifts, and recipients.

Getting Your API Key

Create an API Key: Use the POST /v2/authentication/apiKeys endpoint to generate a new API key
Set Expiration: Choose from 30, 60, 90, or 180 days (default: 90 days)
Optional mTLS: Enable mutual TLS for enhanced security
Name Your Key: Provide a descriptive name for easy identification

Using Your API Key

Include your API key in the X-Api-Key header for every request:

X-Api-Key: YOUR_24_CHARACTER_API_KEY

API Key Management

Maximum Keys: Up to 3 active API keys per company
Rotation: Delete old keys before creating new ones when at the limit
Security: Keys are hashed and cannot be retrieved after creation

Enhanced Security (mTLS)

For production environments, enable mutual TLS authentication:

Set enforceMtls: true when creating the API key
Contact support to obtain your client certificates
Use the mTLS endpoint: https://mtls-api.snappy.com/public-api

Headers

Request-Source

enum<string>

Source of the request

Available options:

api_native,

api_zapier,

api_salesforce,

api_ftp,

api_make

Example:

"api_native"

Query Parameters

companyId

string

Company ID

Pattern: ^[A-Za-z0-9]{8,}$

Example:

"12345678"

Body

application/json

Create account request body.

name

string

required

The name of the account

Example:

"Snappy"

billingMethod

object

required

Billing method configuration.

Show child attributes

Example:

{
  "type": "INV",
  "amount": 100,
  "name": "Invoice 1"
}

Response

Created

Created account.

string

The id of the account.

Example:

"a12bcd34"

name

string

The name of the account.

Example:

"Snappy"

createdAt

string<date-time>

Date Format: YYYY-MM-DDThh:mm:ss.sZ.

Example:

"2022-12-06T09:50:38.536Z"

updatedAt

string<date-time>

Date Format: YYYY-MM-DDThh:mm:ss.sZ.

Example:

"2022-12-06T09:50:38.536Z"

companyId

string

The id of the company.

Example:

"A1b2C3d4"

Last modified on June 17, 2026

Get accounts

Get account by ID