# Intake Addresses

> Solarium docs. All requests are `POST https://api.trysolarium.com/graphql/` with `Authorization: Bearer <api key>` and a JSON body `{"query": ..., "variables": ...}`. Every query and mutation takes an `organizationId` (find it with `myOrganizations`). Index of all pages: https://trysolarium.com/llms.txt

## List Intake Addresses

Returns all registered email addresses and phone numbers that route receipts to the organization.

### Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `organizationId` | `UUID!` | Yes | Organization ID |

### Request

```graphql
query {
  listIntakeAddresses(organizationId: "a1b2c3d4-...") {
    id
    addressType
    address
    label
    active
    created
  }
}
```

### Response

```json
{
  "data": {
    "listIntakeAddresses": [
      {
        "id": "e1f2a3b4-...",
        "addressType": "email",
        "address": "accounting@company.com",
        "label": "Main Office",
        "active": true,
        "created": "2026-05-12T10:30:00Z"
      },
      {
        "id": "c5d6e7f8-...",
        "addressType": "sms",
        "address": "14165551234",
        "label": "Owner",
        "active": true,
        "created": "2026-05-12T10:00:00Z"
      }
    ]
  }
}
```

## Create Intake Address

Register a new email address or phone number for receipt intake. Each address is globally unique — it can only belong to one organization.

### Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `organizationId` | `UUID!` | Yes | Organization ID |
| `addressType` | `String!` | Yes | "email" or "sms" |
| `address` | `String!` | Yes | Email address or phone number (digits only for SMS) |
| `label` | `String` | No | Optional display label (e.g. 'Main Office') |

### Request

```graphql
mutation {
  createIntakeAddress(
    organizationId: "a1b2c3d4-..."
    addressType: "email"
    address: "receipts@company.com"
    label: "Shared Inbox"
  ) {
    intakeAddress {
      id
      addressType
      address
      label
    }
    success
    error
  }
}
```

### Response

```json
{
  "data": {
    "createIntakeAddress": {
      "intakeAddress": {
        "id": "f9a8b7c6-...",
        "addressType": "email",
        "address": "receipts@company.com",
        "label": "Shared Inbox"
      },
      "success": true,
      "error": null
    }
  }
}
```

## Delete Intake Address

Remove a registered intake address. Receipts from this address will no longer route to the organization.

### Arguments

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `organizationId` | `UUID!` | Yes | Organization ID |
| `intakeAddressId` | `UUID!` | Yes | Intake address ID to remove |

### Request

```graphql
mutation {
  deleteIntakeAddress(
    organizationId: "a1b2c3d4-..."
    intakeAddressId: "f9a8b7c6-..."
  ) {
    success
    error
  }
}
```

### Response

```json
{
  "data": {
    "deleteIntakeAddress": {
      "success": true,
      "error": null
    }
  }
}
```