Topics

A topic is a kind of email a contact can choose to get, such as product news or a weekly digest. Every campaign sends on one topic, and contacts turn topics on and off on the preference page.

Create a Topic

Open Contacts › Topics and click New Topic. Each workspace starts with a Marketing topic, which is the default. A workspace can have up to 100 topics.

• On by default gives the topic to every contact until they turn it off.
• Show on preference page lets contacts see and change the topic.
• Double opt-in sends a confirmation email before the contact is subscribed.
• Sign-up form gives the topic a public form.

Subscriptions

A contact gets a topic when their topic status is subscribed, or when they have no status and the topic is on by default. Set the status with the topics field of the contacts API.

curl -X PATCH https://api.inboxjot.com/v1/contacts/riti@example.com \
  -H "Authorization: Bearer $INBOXJOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "topics": [{ "id": "<topic_id>", "status": "subscribed" }]
  }'

Preference Page

Every campaign and automation email has an unsubscribe link and one-click List-Unsubscribe headers. The link opens a preference page where the contact turns topics on and off, unsubscribes from all email, or pauses all email for 30 days.

Change the heading, the message and the options of this page in Settings › Unsubscribe Page.

Sign-up Forms

Turn on the sign-up form of a public topic to collect contacts from your site. The form posts email and optional first_name and last_name to POST /v1/forms/{topic_id}.

<form method="POST" action="https://api.inboxjot.com/v1/forms/<topic_id>">
  <input type="email" name="email" required />
  <input type="text" name="first_name" />
  <button type="submit">Subscribe</button>
</form>

With double opt-in, the contact gets a confirmation link that works for 7 days. After they subscribe, the form can redirect to your own page.