Setting up the Speakap integration

This integration is available on the Integrate plan and above.

Members receive suggested posts as a chat message in Speakap. These chats are sent from one dedicated Speakap user. The setup has two parts: first you add the Apostle application in Speakap, then you connect the Speakap connector in Apostle.

What you need

You collect four items along the way and enter them in Apostle.

Item	Where to find it	Good to know
APP ID	Notification right after adding the application in Speakap	Shown only once, save it immediately
APP SECRET	Notification right after adding the application in Speakap	Shown only once, save it immediately
NETWORK ID	Cogwheel icon next to the application in Speakap Market	Can be retrieved again later
API_KEY	Request it via Speakap Support	You cannot find or create it yourself. It is needed to send chats

💡 Tip: Request the API_KEY from Speakap Support before you start. You need it in step 3 and it is the only item that depends on someone else.

Step 1: Add the application in Speakap

In your Speakap environment, go to Settings and then Network settings.
Go to Speakap Market.
Click + Application.
Choose Add your own application.
Paste the manifest below into the input screen that opens.
Click Add application.
A notification opens with the APP ID and APP SECRET. Save both immediately.
Choose Entire network to close the window.

⚠️ Important: You cannot retrieve the APP ID and APP SECRET after closing the notification. If you lose them, you need to add the application again.

Manifest to paste in step 5:

{
    "name": { "en-US": "Apostle Social", "nl-NL": "Apostle Social" },
    "icon": "https://assets.apostle.social/logo-bordered.png",
    "permissions": ["send_alerts", "post_updates", "get_profiles", "upload_files"],
    "entries": [
        {
            "position": "main",
            "devices": "desktop",
            "url": "https://staging.api-apostle.com/speakap/entry",
            "label": { "en-US": "Apostle Social", "nl-NL": "Apostle Social" },
            "icon": "https://assets.apostle.social/logo-bordered.png",
            "responsive": true,
            "hasMenuItem": false
        },
        {
            "position": "main",
            "devices": "ios",
            "url": "https://staging.api-apostle.com/speakap/entry",
            "label": { "en-US": "Apostle Social", "nl-NL": "Apostle Social" },
            "icon": "https://assets.apostle.social/logo-bordered.png",
            "responsive": true,
            "hasMenuItem": false
        },
        {
            "position": "main",
            "devices": "android",
            "url": "https://staging.api-apostle.com/speakap/entry",
            "label": { "en-US": "Apostle Social", "nl-NL": "Apostle Social" },
            "icon": "https://assets.apostle.social/logo-bordered.png",
            "responsive": true,
            "hasMenuItem": false
        },
        {
            "position": "settings-page",
            "devices": "desktop",
            "url": "https://staging.api-apostle.com/speakap/settings",
            "lightboxTemplate": "close"
        }
    ]
}

Step 2: Retrieve the NETWORK ID

In Speakap Market, click the cogwheel icon next to the application you just created.
A window opens with your NETWORK ID. Save it.

You can retrieve the NETWORK ID this way at any time.

Step 3: Create the connector in Apostle Social

Go to Integration Connectors.
Click Add connector and select Speakap.
Enter the APP ID, APP SECRET, NETWORK ID and API_KEY.

Step 4: Connect a Speakap user for chats

Apostle sends suggested posts through the Speakap chat. The chats are sent from one Speakap user to all connected ambassadors, so you need to connect that user in Apostle.

⚠️ Important: Do not log in with your own account. You cannot send chats to yourself. We recommend creating an extra user in Speakap and naming it “Apostle Social”. Ambassadors receive their suggested posts in the chat from this account.

In Speakap, create a new user and name it “Apostle Social”.
In Apostle, go to the Speakap connector. Once you have entered the API_KEY, a key icon appears next to the connector.
Click the key icon. The Connect Speakap window opens.
Enter the username and password of the Apostle Social user.
Click Connect.
After a successful login, check how long the chat token is valid and which account is connected.

Note: To connect a different account, enter new login details to replace the current one. Click Remove login to remove the connected account.

Step 5: Sync users

Click Users on the connector.
Start the sync. Existing Speakap users are automatically created and linked in Apostle.

After the initial sync, everything runs automatically:

New Speakap users are created in Apostle.
Changes to first name, last name or email address are applied.
Deleted users are also removed from Apostle.

⚠️ Important: Users need to be synced first before they are able to receive posts via Speakap. This applies to both users who are already active in Apostle and newly added users imported from Speakap without an existing Apostle account.

Sending posts via Speakap

Scheduling posts works the same way you are used to in Apostle. No additional steps are required to deliver a post to synced members via Speakap.

Create a post via Create post.
In Choose Channels, assign the variants to the right members.
Set your date and time.
Click Plan this post.

⚠️ Important: A synced Speakap user will no longer receive emails with suggested posts and can only share via Speakap. This is intentional, as Speakap members are not familiar with Apostle and can do everything from within their familiar environment.

💡 Tip: Send a test post to yourself first to check the full flow before sending it to your members.

Business pages and channels

If you have connected business pages in Apostle, suggested posts for those pages will also be delivered via Speakap. Members receive these posts in the same way as personal posts, via the chat.

The channels available depend on the pages you have connected in Apostle. Possible channels are:

Personal LinkedIn
Business page LinkedIn
Business page Facebook
Business page Instagram
Business page X

Note: Posting to personal Facebook and Instagram accounts is not yet available via Speakap.

Insights

Posts shared via Speakap are visible in Team insights and Post insights. All statistics are retrieved, including reach and engagement per post and per user. It is currently not possible to filter on whether a post was shared via Speakap or via another channel.

Note: Posts shared via Speakap are registered as shared via email.