Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.snappy.com/llms.txt

Use this file to discover all available pages before exploring further.

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.

The Account Object

FieldTypeDescription
idstringUnique identifier for the Account
namestringDisplay name of the Account
companyIdstringThe ID of the Company this Account belongs to
billingMethodobjectThe default billing method assigned to this Account
billingMethod.typestringThe billing method type (e.g. INV for invoice)
billingMethod.amountnumberThe available balance on this billing method
createdAtstringISO 8601 timestamp of when the Account was created
updatedAtstringISO 8601 timestamp of the last update

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.

Billing Methods

An Account can have multiple billing methods. For details on how billing methods are used when creating campaigns, see the Campaigns documentation.

How to Work with Accounts

Retrieving Accounts To retrieve a list of all Accounts available to your API key:
GET /accounts
To retrieve a specific Account by ID:
GET /accounts/{id}
Creating an Account Accounts can be created via the API:
POST /accounts
Last modified on April 30, 2026