Buttondown Documentation
Linktree is a tool that compiles social media pages, websites, and newsletters in a single shareable landing page.
This topic explains how you can grow your Buttondown subscriber base through Linktree. To do this, you must create a webhook in Zapier.
Webhooks are useful tools that can automate workflows between two or more apps. Zapier relies on webhooks to create "Zaps" (which is just their term for "automated workflows"). In this doc, we'll use Zapier to create a webhook that takes new subscribers' information from Linktree and adds it to your Buttondown subscriber base.
To complete this process, you must have:
To create your webhook in Zapier, log into Zapier account and click Create Zap to begin setting up your webhook.
Next, you must assign the webhook's trigger, or the event that your webhook recognizes in order to perform a followup action. Here's how:
This video shows how to search for "Webhooks by Zapier" and choose the "Catch Hook" event.
Now it's time to test your new webhook. Here's how:
This video shows how to find and copy the webhook URL.
Next, you'll add the webhook URL to Linktree. Here's how:
After you add the webhook URL, your new sign-up field should appear on the preview of your landing page.
This video shows how to enable the "Email Sign-up" field and paste the webhook URL.
Now it's time to trigger your webhook. Here's how:
This video shows someone using the sign-up field in Linktree.
This video shows a successful test result in Zapier.
Next, determine the action that your webhook will complete after it's triggered. Here's how:
This video shows how to choose the "Create Subscriber" action in Zapier.
At this stage, if you haven't already integrated your Buttondown account with Zapier, you may be prompted to sign in to your Buttondown account with your API Key. You can access your API key in the "API" section of your Buttondown Settings.
Now you can select the data that your webhook will deliver to Buttondown. Select "Email," and otherwise include as many other options as you'd like.
This video shows further configuration options in Zapier.
In Zapier, click Test Action, and within a few seconds, Zapier should send you a result featuring your test email.
This video shows a successful test event in Zapier.
Now, navigate to your Subscribers page in Buttondown. Your test email should appear here as well.
This video shows a successful test user in the Buttondown "Subscribers" page.
This means your webhook is up, running, and ready to be published.
You've done it! Click Publish Zap in Zapier and marvel at the wonders of automated workflows.
This video shows the Publish Zap button being clicked.
Webhooks can do a lot, including adding tags and metadata to new subscribers.
You can use Tags to sort your subscriber base, as well as to send out targeted email blasts. Like tags, metadata can also provide additional context for subscribers.
So, how do you add tags and metadata to webhooks? In this case, start by scrolling down to the "Action" tab in your Zapier editor. From here, you can populate the "Tag" and "Metadata" sections. Just make sure to double check that any new tags and metadata show up when you test your webhook action!
This video shows how to add tags and metadata in Zapier.
After you test your webhook's action in Zapier, your new subscriber, their tags, and their metadata, will appear in your Buttondown subscriber base. Navigate to the "Notes" for any given subscriber to manage their tags, metadata, and other details.
This video shows how to access the "Notes" section for a subscriber.
That's it! On top of sending new subscribers to Buttondown, your webhook will now also help you sort them into your subscriber base.