You will need your beehiiv API Key to connect beehiiv with AEvent. The API Key is created inside your beehiiv dashboard.

To retrieve your API Key:

API access is available on beehiiv plan tiers that include the API. If you do not see the API page, check that your beehiiv plan includes API access. You can review beehiiv's own guidance in the beehiiv API documentation.
​

To connect your beehiiv account to AEvent, first navigate to Integrations inside AEvent, click Add Integration, then search for and select beehiiv.
​

Name your integration as you see fit, then click Add.
​

You will then be prompted to enter the one value required to connect your beehiiv account:

Paste your beehiiv API Key into the API Key field, then click Connect.
​

Once your beehiiv account has been successfully added, you will see its Connected state, and you will be able to click Test. A successful test result confirms that your beehiiv account is now connected to AEvent.
​

In order to use your beehiiv Integration within AEvent, you first need to activate it inside the campaign you are working on.

Open the campaign you want to use, click on Integrations, and set your beehiiv Integration to Active by toggling it on.
​

Every beehiiv timeline action asks you to choose a Publication first. In beehiiv, a Publication is the top-level container that holds your newsletter lists, custom fields, and tags. Selecting the right Publication tells AEvent which beehiiv audience to act on.

​What it does: Adds a tag to the subscriber in beehiiv, so you can segment people by what they did during your event (for example, "attended" or "clicked the offer").

When to use it: When you want to group registrants in beehiiv for later targeting.

To set up this action, within the Timeline Builder create an action and set the date, time, and audience. Select your beehiiv Integration, choose the Publication, then choose Add Subscription Tag. Type the Tag Name you want applied, then click Create.
​

You type the Tag Name by hand rather than picking it from a list. beehiiv creates the tag automatically if it does not already exist. Each publication supports up to 100 tags.
​

​What it does: Subscribes the registrant to a specific beehiiv newsletter list, so the right people start receiving that newsletter based on what happens in your campaign.

When to use it: When you want event activity to add someone to a newsletter list automatically.

To set up this action, within the Timeline Builder create an action and set the date, time, and audience. Select your beehiiv Integration, choose the Publication, then choose Add Newsletter List Subscription. Pick the Newsletter List from the dropdown, then click Create.
​

The Newsletter List is chosen from a dropdown that AEvent populates from the Publication you selected.
​

If your beehiiv connection stops working, the most common fix is to reconnect it using a fresh API Key.

To reconnect, navigate to Integrations in AEvent, locate your beehiiv integration, and click Re-Connect. You will be prompted to re-enter your API Key.

To retrieve a current API Key, return to beehiiv, open Settings, then API, and copy an active key (or create a new one). Paste it back into AEvent, then click Test to confirm. Once the test is successful, your beehiiv integration is fully reconnected and ready to use again.
​

If you want to remove your beehiiv integration from AEvent, navigate to Integrations, locate your beehiiv integration, and click the trashcan icon. You will then be prompted to confirm the removal.
​

Removing this integration will immediately affect its use with any campaigns that it is active in.

If you are experiencing issues but do not want to remove it entirely, we recommend reconnecting it instead. You can always re-add the integration later.