Skip to main content
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

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
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
Returns the details of a specific Account by its ID. Create an Account
Creates a new Account under your Company with an initial Billing Method (currently invoice-only via the API).
Last modified on June 18, 2026