Accounts API (V3): Organize Gifting by Team, Department, or Budget

An Account lives within a Company and lets you separate and organize gifting activity for different teams, departments, or budget owners - each with its own campaigns and Billing Method.

Want to understand how Accounts fit into the bigger picture? Check out the Core Concepts & Data Models page.

Looking for the V2 endpoints? See Accounts (V2). Both V2 and V3 are supported in parallel.

The Account Object

Field	Type	Description
`id`	string	Unique identifier for the Account (e.g. `a12bcd34`)
`name`	string	Display name of the Account
`companyId`	string	The ID of the Company this Account belongs to
`createdAt`	string (ISO 8601)	Timestamp when the Account was created
`updatedAt`	string (ISO 8601)	Timestamp of the most recent update

Billing Methods belong to an Account but are managed via the dedicated Billing Methods API. Use GET /v3/billing-methods with the Snappy-Account-Id header to retrieve the billing methods available on a given Account.

Key Concepts & Business Rules

Accounts organize your gifting activity

All Campaigns and Gifts are created within an Account. If your organization has multiple teams or departments sending gifts independently, each should operate through its own Account with its own budget and Billing Method.

One default Billing Method per Account

Each Account has one Billing Method set as the default. This default is applied automatically to any Campaign created via the API. Campaigns created through the Dashboard allow explicit Billing Method selection at the time of creation. Embedded Marketplace (POST /v3/orders) references the Billing Method explicitly via the billingMethodId field.

Initial billing setup via Create Account

The POST /v3/accounts endpoint accepts an initial Billing Method (currently invoice-only - type: INV) at Account creation time. To configure other Billing Method types (Prepay, PO, Credit Card), create the Account first and then set up the Billing Methods via the Snappy Dashboard.

Account scoping in other APIs

Most V3 APIs (Billing Methods, Orders, product retrieval) accept a Snappy-Account-Id header to scope queries to a specific Account when your API key has access to multiple Accounts.

How to Work with Accounts (V3)

List Accounts

GET /v3/accounts

Returns a paginated list of Accounts available to your API key. Filter by filter[name], paginate with page[number] / page[size], and control returned fields with the fields parameter. Get a single Account

GET /v3/accounts/{accountId}

Returns the details of a specific Account by its ID. Create an Account

POST /v3/accounts

Creates a new Account under your Company with an initial Billing Method (currently invoice-only via the API).

​The Account Object

​Key Concepts & Business Rules

​Accounts organize your gifting activity

​One default Billing Method per Account

​Initial billing setup via Create Account

​Account scoping in other APIs

​How to Work with Accounts (V3)

The Account Object

Key Concepts & Business Rules

Accounts organize your gifting activity

One default Billing Method per Account

Initial billing setup via Create Account

Account scoping in other APIs

How to Work with Accounts (V3)