---
title: "Subscribe a person to The Pulse by email with their explicit newsletter consent and chosen format, frequency and language. Validate with dryRun:true first. Live calls store a subscription, send a confirmation email and notify the team. Save an idempotencyKey before sending and reuse it with identical input for retries within 7 days; never retry an uncertain action with a new key."
method: POST
path: "/api/agent/subscribe_pulse"
tags: ["Agent tools"]
---

# Subscribe a person to The Pulse by email with their explicit newsletter consent and chosen format, frequency and language. Validate with dryRun:true first. Live calls store a subscription, send a confirmation email and notify the team. Save an idempotencyKey before sending and reuse it with identical input for retries within 7 days; never retry an uncertain action with a new key.

`POST /api/agent/subscribe_pulse`

## Request

- Base URL: `https://www.reguscilabs.com`
- URL: `https://www.reguscilabs.com/api/agent/subscribe_pulse`
- Auth: none required

Compatibility alias for the v1 endpoint; no removal is scheduled.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `name` string, required
  - `email` string, email, required
  - `whatsapp` string
  - `deliveryFormat` 'audio' | 'text' | 'both', required
  - `cadence` 'daily' | 'weekly', required
  - `consent` true, required: The person explicitly opted into The Pulse. An inquiry does not imply newsletter consent.
  - `idempotencyKey` string: Unique key for one approved live action. Reuse it with identical input for retries for 7 days; use a new key for a different intended action. Without a key, automatic retry is unsafe.
  - `locale` 'es' | 'en'
  - `dryRun` boolean: Defaults to true: validate only, with no delivery or storage. Set false only for an approved live submission.
  - `confirmed` boolean: Set true only after the person explicitly approves sending these details to RegusciLabs.

## Response `200`

Typed result. Search, latest-news and curated-social-activity lists may return nextCursor (null at the end); reuse it with unchanged filters. Social activity is editorial, not live, with null dates when unverified. Validation always has submitted:false.

- union
  - object
    - `ok` true, required
    - `dryRun` true, required
    - `submitted` false, required
    - `message` string, required
  - object
    - `ok` true, required
    - `dryRun` false, required
    - `submitted` true, required
    - `subscribed` true, required
    - `replayed` boolean
    - `confirmationEmailSent` boolean, required
    - `message` string, required

## Other responses

- `400`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `403`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `404`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `405`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `409`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `413`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `415`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `429`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `502`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.
- `503`: Structured error with a code, message and resolution. An uncertain live outcome must not be retried automatically.

---

[API](https://skmtc.dev/reguscilabs/apis/reguscilabs-innovation-lab-agent-api.md) · [All operations](https://skmtc.dev/reguscilabs/apis/reguscilabs-innovation-lab-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reguscilabs/apis/reguscilabs-innovation-lab-agent-api/revisions/5625dbe6df54?raw)