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.
The Account Object
| Field | Type | Description |
|---|
id | string | Unique identifier for the Account |
name | string | Display name of the Account |
companyId | string | The ID of the Company this Account belongs to |
billingMethod | object | The default billing method assigned to this Account |
billingMethod.type | string | The billing method type (e.g. INV for invoice) |
billingMethod.amount | number | The available balance on this billing method |
createdAt | string | ISO 8601 timestamp of when the Account was created |
updatedAt | string | ISO 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:
To retrieve a specific Account by ID:
Creating an Account
Accounts can be created via the API:
Last modified on June 18, 2026