How to integrate with other tools on PostHog

intermediate 8 min read Updated 2026-03-18
Quick Answer

PostHog integrates with external tools through Apps, Webhooks, and API connections available in the project settings. Navigate to the Apps tab to browse and configure integrations with popular tools like Slack, Zapier, and Salesforce.

Prerequisites

  • Active PostHog account with admin access
  • API keys for target tools (Slack, Zapier, etc.)
  • Basic understanding of webhooks and APIs
  • Project setup with event tracking enabled

Step-by-Step Instructions

1

Access PostHog Apps Directory

Log into your PostHog dashboard and click on Apps in the left sidebar. This opens the PostHog Apps directory where you can browse available integrations. Click Browse Apps to see all available third-party tool integrations including Slack, Zapier, Salesforce, and webhook connectors.
Filter apps by category or search for specific tools to quickly find the integration you need.
2

Install Your Desired Integration

Find the tool you want to integrate and click Install on its app card. For example, to integrate with Slack, click on the Slack App and then Install. PostHog will prompt you to configure the app with your credentials. Click Configure to proceed to the setup screen.
Read the app description and requirements before installing to ensure compatibility with your use case.
3

Configure Authentication and Permissions

Enter the required authentication details for your target tool. For Slack, paste your Slack Bot Token in the token field. For Zapier, copy the provided Webhook URL. Enable the integration by toggling the Enabled switch to on. Click Save to store your configuration.
Store your API keys securely and use environment variables for sensitive credentials when possible.
4

Set Up Event Triggers and Filters

Navigate to the Configuration tab of your installed app. Define which PostHog events should trigger actions in your connected tool. Use the Event Filters section to specify conditions like event names, user properties, or feature flags. For example, set event = 'user_signup' to trigger notifications only for new user registrations.
Start with simple filters and gradually add complexity to avoid overwhelming your connected tools with notifications.
5

Configure Data Mapping and Formatting

In the Data Mapping section, specify which PostHog data fields should be sent to your external tool. Map PostHog properties to corresponding fields in your target system. For Slack notifications, customize the message template using variables like {{event.name}} and {{person.properties.email}}. Click Preview to test your formatting.
Use PostHog's property mapping to ensure data consistency across your integrated tools.
6

Test the Integration

Click Send Test Event to verify your integration is working correctly. Check your connected tool (Slack channel, Zapier dashboard, etc.) to confirm the test data arrived as expected. Review the Activity Log in PostHog to see successful deliveries and any error messages. Make adjustments to your configuration if needed.
Always test integrations with sample data before enabling them for production events.
7

Set Up Webhooks for Custom Integrations

For tools not available in the Apps directory, go to Project Settings > Webhooks. Click Create Webhook and enter your target tool's webhook URL. Configure the Event Types you want to send, set up authentication headers if required, and customize the JSON payload format. Enable the webhook and click Save.
Use webhook testing tools like ngrok or RequestBin to debug custom webhook integrations during development.
8

Monitor and Maintain Your Integrations

Regularly check the Apps dashboard to monitor integration health and delivery rates. Review error logs in the Activity section for failed deliveries. Update authentication tokens before they expire and adjust event filters as your data needs evolve. Set up alerts in PostHog to notify you of integration failures.
Create a maintenance schedule to review and update your integrations monthly to ensure optimal performance.

Common Issues & Troubleshooting

Integration fails to authenticate

Verify your API keys and tokens are correct and haven't expired. Check that you have proper permissions in the target tool. Re-enter credentials in the PostHog app configuration and ensure any required scopes are granted.

Events not triggering in connected tools

Review your event filters in the app configuration - they may be too restrictive. Check the Activity Log for delivery attempts and errors. Verify that the events you're testing actually exist in your PostHog data.

Webhook deliveries timing out

Check if your webhook endpoint is accessible and responding within 30 seconds. Verify the webhook URL is correct and the receiving service is running. Consider implementing a webhook queue if your endpoint needs more processing time.

Data mapping errors in integrated tools

Ensure PostHog property names match the expected format in your target tool. Check for special characters or spaces in property names that might cause issues. Use the data mapping preview feature to validate your configuration before saving.

Prices mentioned in this guide are pulled from current plan data and may change. Always verify on the official PostHog website before purchasing.