Accounts API (V2): 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 V3 endpoints? See Accounts (V3). 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 not currently exposed through the V2 API as a separate resource. To list billing methods on an Account programmatically, use the V3 Billing Methods API.

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.

Initial billing setup via Create Account

The POST /v2/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.

How to Work with Accounts (V2)

List Accounts

GET /v2/accounts

Returns a paginated list of Accounts available to your API key. Filter by companyId or name, control returned fields with fields, and paginate with skip and limit. Get a single Account

GET /v2/accounts/{accountId}

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

POST /v2/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

​How to Work with Accounts (V2)

The Account Object

Key Concepts & Business Rules

Accounts organize your gifting activity

One default Billing Method per Account

Initial billing setup via Create Account

How to Work with Accounts (V2)