IndiePitcher

API Reference

Login

Support

Returns paginated mailing lists contacts can subscribe to.

Retrieve mailing lists

The unique name of the mailing list meant to be used by the public API. Not intended to be shown to the end users, that's what `title` is for.

The number of contacts subscribed to this list.

A human-readable name of the mailing list.

apiKey

IndiePitcher - Everything email for your startup

Start here

Contacts

Mailing Lists

SMTP

Interact with IndiePitcher programatically

API Keys

Personalize your emails with recipient-specific information

Email Personalization

Send emails from your own domain with IndiePitcher

Sending Domains

SDKs

Supabase

Use IndiePitcher with your server-side Swift apps

Swift

Introduction

The email is not required to belong to a contact in your contact list. Use this API to send emails such as that a user who is not signed up for your product was invited to a team.

<Warning>
Do not send bulk (marketing) emails through this endpoint, we have pretty extensive checks, especially for the free tier users using the default sending tomain.
The expected use case is to send transactional emails such as email resets, welcome emails, and other emails that are triggered by user actions.

Please contact the support if you do have a valid use case for sending bulk emails through the SMTP proxy to have your project whitelisted.
</Warning>

Sends an email to specified email address.

Send a personalized email to one more (up to 100 using 1 API call) contacts subscribed to a proviced mailing list. This is the recommended way to send an email to members of a team of your product. All provided emails must belong to your mailing list and must be members of provided mailing list. All contacts are automatically subscribed to `important` default mailing list. You can use peronalization tags such as `Hi {{firstName}}` to peronalize individual sent emails, and scheduled it to be sent with a delay.

Send an email to one of more registered contacts.

This is the recommendat way to send a newsletter, by creating a list called something like `Newsletter`. All contacts are automatically subscribed to `important` default mailing list. You can use peronalization tags such as `Hi {{firstName}}` to peronalize individual sent emails, and scheduled it to be sent with a delay.

Send an email to registered contacts in a mailing list.

Returns a paginated list of stored contacts in the mailing list.

Retrieve contacts

Add a new contact to the mailing list, or update an existing one if `updateIfExists` is set to `true`.

Add a new contact

Add miultiple contacts (up to 100) using a single API call to avoid being rate limited. Payloads with `updateIfExists` is set to `true` will be updated if a contact with given email already exists.

Add multiple contacts using a single API call

Updates a contact with given email address. This call will fail if a contact with provided email does not exist, use `addContact` instead in such case.

Update an existing contact

Deletes a contact with provided email from the mailing list

Delete a contact

Generates a new public URL for a contact with provided email to manage their mailing list subscriptions.

API Documentation

Email

Contacts

Mailing Lists

Retrieve mailing lists

Authorizations

Query Parameters

Response