PulsePigeonemail infrastructure

Getting started

What does PulsePigeon send?

PulsePigeon sends transactional, lifecycle, and marketing email through the REST API, customer campaigns, and event-driven automations. SMTP submission is not available yet. Send with the REST API today.

Is there a free plan, and can I sign up myself?

Yes. Create an account at /register with Google sign-in, or use a work email and confirm the verification link. Both paths provision the free workspace immediately without a sales call. The Free plan includes 3,000 recipient emails per month, 500 active contacts, one verified sending domain, and a 7-day log target.

REST API or SMTP?

Use POST /v1/messages for retry-safe API sending. SMTP submission is not available yet. It is built for a controlled rollout but is not publicly reachable. Send with the REST API today.

Do I have to email support to get approved before I can send?

No. Signup and workspace provisioning complete in the same verified registration flow. Production sending still requires domain readiness, and accounts that trigger abuse signals can be held for manual risk review.

What happens if we hit a plan or spend limit?

The send is rejected before acceptance with HTTP 402 or 429 when a hard limit would be exceeded. It is not sent or converted into an automatic overage. Current plans have no paid overage; wait for the monthly allowance reset or upgrade. Contact, domain, daily safety, warm-up and consent controls remain separate.

Are plan limits based on send volume, contact count, or both?

Both are enforced independently: a monthly send cap and an active-contact cap for each plan tier.

My send returned 2xx but the email never arrived. Where do I start?

Check the diagnostic checklist (role, project mode and captured marker, API key and project mode match, vetting, verified sending domain, send control, recipient blocks, plan limits, batch item failures, and post-acceptance outcomes such as deferred, bounced, or failed). Do not resend unconditionally: unchanged failed items retry with their original Idempotency-Key; corrected messages use a new key.

Why does my Test project send never reach a real inbox?

Test projects capture sends for inspection and never hand them to a provider. The API returns a captured marker (delivery_mode=test_capture) on every accepted Test send. Test mode on the normal message API also skips the account review, sender-domain verification, and plan or contact caps. The template Test-send route is the one exception: it requires the account review in every mode, including Test. On a Live project it queues a real delivery to caller-chosen recipients; on a Test project the send is still captured, not delivered.

Reputation and lane isolation

Does PulsePigeon mix my transactional and marketing traffic?

Mail uses separate critical, transactional, briefing, marketing, and third-party routing and reputation controls. This limits spillover, but a shared provider or platform incident can still affect more than one lane.

Deliverability and authentication

Do I need SPF, DKIM, and DMARC set up?

Adding a domain generates SPF, DKIM, and DMARC records and tracks each verification result. Google, Yahoo, and Microsoft impose additional authentication requirements for high-volume senders. Their policies change, so review current primary guidance before a large launch.

Why are my emails landing in spam even though DNS checks pass?

Authentication is necessary but not sufficient. Mailbox providers also weigh sender reputation, engagement, volume patterns, and content signals. Passing DNS checks never guarantees inbox placement.

Do you monitor blocklists and DMARC aggregate reports?

The platform includes authenticated blocklist and DMARC aggregate-report ingestion with operator views for alignment, disposition, and authentication results. Those views explicitly report disabled, stale, or no-data feed states. Monitoring is active only after the production feed is configured and verified.

Do you offer dedicated IPs, or shared pools?

Sending uses reputation-managed shared pools by default, with quarantine controls for tenants showing abuse signals. Dedicated IPs are an operator-gated beta for eligible Scale and Enterprise tenants, available by request. They are not generally available and not self-serve. Contact support to ask about eligibility and the warm-up steps.

Templates and integration

Do you have a drag-and-drop email builder?

No. Templates use named variables, HTML and plain-text bodies, validation, and linting through the API. The visual workflow builder is not an email-template builder.

Do you support idempotency keys?

Yes. POST /v1/messages accepts an optional Idempotency-Key. Repeating the same key and body returns the original result; reusing a key with a different body returns 409.

Do you have a client SDK for our stack?

Use the TypeScript and Python integration guides for server-side applications. The SDK page shows the current package release status and installation options. The cURL tab provides the REST path.

Campaigns and automation

Can I send a one-off marketing broadcast, not just transactional API calls?

Yes. The authenticated /campaigns composer lets customers select a segment and published template, inspect a suppression-safe audience estimate, schedule or send, and review delivery results. Campaigns enter the marketing lane. Separate sending lanes share one workspace email allowance across broadcasts, app messages and automations.

Can I trigger emails off events instead of calling the API for each one?

Yes. Automations use versioned visual workflows with send, wait, condition, weighted split, and stop nodes. You can validate and publish an immutable version, pause or resume it, inspect run and step history, and replay eligible failed runs.

Can I send personalized messages in one API request?

Yes. POST /v1/messages/batch accepts 1 to 100 independently personalized items with per-item idempotency and partial results.

Do you support double opt-in for marketing subscribers?

Yes. Subscriber lists can require confirmation before an address becomes subscribed.

Is there a CLI, or only the REST API and SDKs?

Use the REST API or the TypeScript and Python integration guides. There is no public CLI package today.

Webhooks, logs, and compliance

How do I get delivery, bounce, and complaint events?

Configure signed HMAC-SHA256 status webhooks at /webhooks. Deliveries use exponential-backoff retries and dead-letter handling, and message events are also visible in the console.

How long are logs retained?

Plan targets are 7 days on Free, 30 on Starter, 90 on Growth, and 365 on Scale. The scheduled purge audit runs automatically in dry-run mode by default. Real deletion remains evidence-gated until a fresh backup, scratch restore, and reviewed production dry run are recorded. Contact support to confirm what applies to your workspace.

How does unsubscribe and suppression handling work?

Hard-bounce and complaint suppression is automatic. Hosted RFC 8058 unsubscribe is injected for marketing mail when the public base URL is configured. Multi-recipient marketing sends fan out so each recipient gets its own token, To header, and delivery. Transactional, security, and billing categories do not receive an unsubscribe header.

Migration and what's not included

Can I use another provider's API key without code changes?

No. PulsePigeon has its own API. The email migration guide explains suppression, consent, domain and integration checks; tenant-wide suppression import remains an authenticated console operation rather than a project-key SDK method.

What don't you support today?

PulsePigeon does not provide a drag-and-drop template builder, public AI copywriting assistant, React Email-style compiler, SMS, push, or WhatsApp sending. MCP and agent routes exist for signed product sessions but are not public project-key integrations.

Support

How do I get help?

Use the support desk for product questions, deliverability incidents, and account access issues. AI-assisted answers appear only when a selected provider is configured and ready.