Configure a messaging channel

  1. Create a new messaging channel

    Required

    Before you can design a campaign, you need to configure a messaging channel. Campaigns use messaging channels to deliver messages to your users.

    To create a new channel, go to messaging > Channels tab > click + New channel, and select the channel you want to configure:

    Email is the default messaging channel in PostHog.

    You can use it to send drip campaigns, transactional messages, or announcements directly from the Campaign Builder.

    Configure the channel

    To configure the channel, you need to provide the following details:

    • Enter your from name (e.g. PostHog Team).
    • Enter your from email (e.g. team@yourdomain.com).

    This is the address that recipients will see in their inbox.

    Verify your domain

    To maximize deliverability and avoid spam folders, you must verify your domain.

    1. After adding your email address, PostHog shows DNS records for SPF and DKIM.
    2. Copy these into your domain host (e.g. Cloudflare, GoDaddy).
    3. Verification may take a few minutes to propagate.

    Once verified, you'll see a green check mark in your settings.

    How to verify your domain in PostHog
  2. Create a template

    Recommended

    Navigate to Messaging > Templates tab > click + Create new.

    • Give your template a name.
    • Write your subject line and body content (HTML and text versions are supported).
    • Use variables like {{ person.name }} to personalize your message. See the campaign builder documentation for more information on available variables.

    Save your template — you'll be able to select it later when you design a campaign.

    You'll still be able to edit the message in the campaign builder.

  3. Use in a campaign

    Required

    Once your channel is created, you can use it in a campaign to deliver messages to your users.

    Launch your first campaign
  4. Troubleshooting

    Checkpoint
    Common issues you may encounter
    IssueSolution
    Emails not sending?Check that your domain is verified and you've added the DNS records correctly.
    Spam folder issues?Ensure SPF/DKIM are valid, and consider setting up DMARC.
    Variables not populating?Confirm the property exists on the person profile (e.g. person.name).

Community questions

Was this page useful?

Questions about this page? or post a community question.