> ## 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.

# Accounts API Overview

> Manage accounts, sub-accounts, and budget hierarchy. Endpoints, fields, and common patterns for organizing campaigns by team or initiative.

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.

<Tip>
  Want to understand how **Accounts** fit into the bigger picture? Check out the [Core Concepts & Data Models](/pages/snappy-core-concepts-and-data-models) page.
</Tip>

## 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](/modules/api/v2/campaigns/overview) documentation.

***

## How to Work with Accounts

**Retrieving Accounts**

To retrieve a list of all Accounts available to your API key:

```text theme={null}
GET /accounts
```

To retrieve a specific Account by ID:

```text theme={null}
GET /accounts/{id}
```

**Creating an Account**

Accounts can be created via the API:

```text theme={null}
POST /accounts
```