How can we help you?

Note: This feature is currently in beta. Please contact product@contactmonkey.com to request early access.

Connect Appspace to ContactMonkey to share your email content and analytics with Appspace-powered digital signage and communication channels. This integration uses an API token for secure authentication.

Prerequisites

Before starting, ensure you have:

• Appspace Admin or Owner access to create API tokens
• ContactMonkey Administrator or Owner access to configure integrations
• A service account in Appspace with permissions to access the Stories and analytics you plan to use (recommended for security and stability)
• Access to the specific Appspace content types you need (currently supports Stories only)

Note: Appspace steps may vary based on your deployment type (on-premise, private cloud, or public cloud) and Appspace version. The instructions below are for Appspace 8.0+ on cloud deployments.

What This Integration Does

This integration enables ContactMonkey to authenticate with Appspace and share content across platforms. Specifically, it:

• Authenticates ContactMonkey to Appspace using a secure API token
• Allows you to share email content or analytics with Appspace Stories
• Centralizes authentication so team members don't need individual Appspace logins for ContactMonkey actions

Supported content types: This version supports Appspace Stories only. If you need support for other Appspace content types, submit a request through the ContactMonkey customer feedback portal.

Step 1: Generate Your Appspace API Token

1. Sign in to Appspace Admin
2. Open the main menu and select Integrations
3. Select API Tokens
4. Click Add to create a new Client/Application
5. Enter a name and description. Assign a Service Account with the appropriate permissions as the user
6. Click Create, then open the newly created Client/Application
7. Turn on Enable API Key
   1. You’ll need the Subject Id and the Refresh Token to integrate with ContactMonkey
8. Click Save

Tip: Store these credentials securely - treat them like a password.

Step 2: Connect Appspace to ContactMonkey

1. Click your name at the top right of the ContactMonkey dashboard
2. Click Settings
3. Click Integrations
4. Scroll to the Channels section and select Appspace
5. Paste the Subject Id into the Subject Id field.
6. Paste the Refresh Token into the Refresh Token field.
7. Click Save.

Your Appspace integration is now active. You can now share ContactMonkey content to Appspace Stories through your campaigns.

Troubleshooting

Problem: Token shows as invalid or expired
Solution: Return to Appspace Admin, regenerate the API token, and update the credentials in ContactMonkey Settings → Integrations → Appspace.

Problem: Insufficient permissions error
Solution: Verify that your Appspace service account has the required access to Stories and any analytics you're trying to use. Update permissions in Appspace, then test the connection again.

Problem: Cannot find Appspace in ContactMonkey Integrations
Solution: The Appspace integration may not be enabled for your workspace. Contact ContactMonkey Technical Support or your Customer Success Manager to enable it.

Problem: Cannot enable API token toggle in Appspace
Solution: Check that your Appspace role has permission to create API tokens and that the Integrations feature is enabled for your Appspace tenant.

Security Best Practices

• Treat tokens as passwords: Store API tokens securely and limit who can view them
• Use a service account: Create a dedicated Appspace user for integrations rather than using a personal account
• Rotate tokens regularly: If your organization requires periodic token rotation, create a new token and update ContactMonkey immediately
• Revoke compromised tokens: If you suspect a token has been exposed, revoke it in Appspace immediately and generate a new one

Known Limitations

• Content type support: Currently supports Appspace Stories only
• Service account scope: Access is limited to what the assigned service account can see in Appspace
• No per-user personalization: Actions in Appspace are performed by the service account, not individual ContactMonkey users
• Analytics timing: Analytics may be delayed, and historical data from before the integration was connected will not be available
• Rate limits: Appspace API rate limits apply and may throttle requests during heavy usage

Frequently Asked Questions

What is a service account?
A service account is a dedicated, non-human Appspace user created specifically for integrations. It holds only the permissions the integration needs and isn't tied to a specific employee. This prevents disruptions when team members change roles and improves security.

Can I use a regular user account instead?
Yes. For small teams or testing, you can use an existing Appspace user with the required access. For production use in larger organizations, a service account is strongly recommended for stability and security.

Do API tokens expire?
Token expiration is managed in Appspace based on your organization's policies. If your organization rotates tokens periodically, update the token in ContactMonkey Settings → Integrations when it's rotated.

Can multiple ContactMonkey workspaces use the same Appspace token?
While technically possible, we recommend creating a unique token per ContactMonkey workspace for better security and easier troubleshooting.

See Also

• Insert an Appspace Story in a ContactMonkey Email