> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Subscriber Notes

> List, create, or delete internal notes for a subscriber

Internal subscriber notes are visible to your team and are not sent to subscribers.

You can manage notes by email or by external ID. Use the external-ID query route for IDs that contain `/`.

## Request

<ParamField path="email" type="string">
  Subscriber email for `/subscribers/{email}/notes`.
</ParamField>

<ParamField query="externalId" type="string">
  External ID for `/subscribers/external/notes?externalId={externalId}`.
</ParamField>

<ParamField body="body" type="string" required>
  Note body. Maximum length: 5000 characters.
</ParamField>

```bash theme={null}
curl "https://api.sequenzy.com/api/v1/subscribers/user%40sequenzy.com/notes" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```bash theme={null}
curl -X POST "https://api.sequenzy.com/api/v1/subscribers/user%40sequenzy.com/notes" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body":"Asked about enterprise pricing"}'
```

```bash theme={null}
curl -X DELETE "https://api.sequenzy.com/api/v1/subscribers/notes/note_123" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Responses

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "notes": [
      {
        "id": "note_123",
        "subscriberId": "sub_abc123",
        "authorId": "user_123",
        "body": "Asked about enterprise pricing",
        "createdAt": "2026-06-28T10:00:00.000Z",
        "updatedAt": "2026-06-28T10:00:00.000Z",
        "author": {
          "id": "user_123",
          "name": "Ana",
          "email": "ana@example.com"
        }
      }
    ]
  }
  ```

  ```json 200 theme={null}
  {
    "success": true,
    "note": {
      "id": "note_123",
      "subscriberId": "sub_abc123",
      "authorId": "user_123",
      "body": "Asked about enterprise pricing",
      "createdAt": "2026-06-28T10:00:00.000Z",
      "updatedAt": "2026-06-28T10:00:00.000Z",
      "author": {
        "id": "user_123",
        "name": "Ana",
        "email": "ana@example.com"
      }
    }
  }
  ```

  ```json 200 theme={null}
  {
    "success": true,
    "deleted": true,
    "id": "note_123",
    "subscriberId": "sub_abc123"
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": "body is required"
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": "Unauthorized"
  }
  ```

  ```json 404 theme={null}
  {
    "success": false,
    "error": "Subscriber not found"
  }
  ```
</ResponseExample>