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

# API introduction

> Base URL, versioning and the response envelope for the Senderz public API.

The Senderz Public API lets you manage contacts, send transactional messages, ingest custom events and subscribe to webhooks — the same surface the Make integration is built on.

## Base URL

<CodeGroup>
  ```bash Production theme={"system"}
  https://api.senderz.app/api/v1
  ```

  ```bash Local development theme={"system"}
  http://localhost:7010/api/v1
  ```
</CodeGroup>

All public endpoints live under the `/api/v1` prefix, **except** a few root-mounted assets: the tracking pixel (`/o.gif`), click redirect (`/c`), storefront bundle (`/storefront/senderz.js`), push service worker (`/storefront/push-sw.js`) and the embedded-form bundle (`/forms/senderz-form.js`).

## Versioning

The API version is `2026-01`, returned by [`GET /public/me`](/en/api-reference/me). New behaviour is added compatibly.

## The response envelope

Every successful response is wrapped:

```json theme={"system"}
{
  "success": true,
  "data": { }
}
```

The shapes documented throughout the reference are the value of `data`. Errors use `success: false` — see [Errors](/en/api-reference/errors).

## The surfaces

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/en/api-reference/authentication">
    The `X-Sender-Tenant` + `X-API-Key` header pair.
  </Card>

  <Card title="Profiles" icon="user" href="/en/api-reference/profiles">
    Create, upsert, update, look up and blacklist contacts.
  </Card>

  <Card title="Lists" icon="list" href="/en/api-reference/lists">
    List segments and manage static list membership.
  </Card>

  <Card title="Messages" icon="paper-plane" href="/en/api-reference/messages">
    Send transactional email and SMS.
  </Card>

  <Card title="Events" icon="bolt" href="/en/api-reference/events">
    Ingest custom events to trigger flows.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/en/api-reference/webhooks">
    Subscribe to outbound events.
  </Card>
</CardGroup>

## Rate limits

Public endpoints inherit a default limit of **60 requests per minute** per caller unless a tighter limit is noted (embedded forms: 10/min). See [Errors](/en/api-reference/errors#rate-limits) for the 429 response.