IndiePitcher

API Reference

Login

Support

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

Retrieve contacts

The custom properties set for this contact.

The date when an attempt to send an email to the contact failed with a hard bounce, meaning the email address is invalid and no further emails will be send to this contact. You can reset this in the dashboard to re-enable sending emails to this contact.

The primary language language of this contact, represented by a language code.

The array of mailing lists the contact is subscribed to.

Represents a custom contact property, which can be a string, number, boolean, or date.

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.

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

Returns paginated mailing lists contacts can subscribe to.

Retrieve mailing lists

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

API Documentation

Email

Contacts

Mailing Lists

Retrieve contacts

Query Parameters

Response