Skip to main content

Manage App Connections

What this does​

App Connections let Franmantra use external services for email, calendars, messaging, social publishing, and other workflows. Connections are grouped by who owns or uses them, so choose the right level before connecting an account.

Before you start​

  • Sign in to the correct sub-account with permission to manage connections.
  • Make sure the external account or service is ready to authorize.
  • For SMTP, get the server, port, authentication username, sender email, and password from your email provider. Use a sandbox/test SMTP account when demonstrating the setup.
  • Never put passwords, API keys, or live authentication tokens in documentation, video-job JSON, source control, or narration.

Open App Connections​

  1. From the application, open Settings.
  2. Choose All Connections in the Settings sidebar.
  3. The page is titled App Connections and has separate Business and Personal tabs.

The page also summarizes connected services, services that need reauthorization, and pending connections. The available options depend on the account and enabled modules.

Choose the connection level​

Business​

Use Business for a service the business or sub-account should share. In the live connection picker, the available examples included Facebook, Instagram, LinkedIn Pages, Instagram Business, Twilio, Mailgun, Custom SMTP, Gmail (SMTP), LinkedIn Leads, and WhatsApp. Availability may vary by account.

Personal​

Use Personal for an integration connected to an individual user's account. The live picker listed Gmail (Two Way sync), Google Calendar, Outlook Calendar, Google Meet, and Outlook Email. Personal OAuth connections are authorized for the individual account rather than configured as shared business credentials.

Add a connection​

  1. Select Business or Personal first. The active tab determines which services appear.
  2. Click New Connection.
  3. Review the integrations in Choose an Integration, then select the service you want.
  4. Follow that service's authorization or configuration form. OAuth services may ask you to sign in with the provider; SMTP services require server and sender details.
  5. Review the settings and save only after checking the connection level and account.

Example: configure a business Custom SMTP connection​

Choose Business → New Connection → Custom Smtp. The configuration form contains:

  • Connection Name: a memorable label for the team, such as Mailtrap Sandbox.
  • Provider Name: the SMTP provider, such as Mailtrap.
  • SMTP Server and SMTP Port.
  • Username, Email, and Password for the SMTP account.
  • Reply Tracking, which should only be enabled when appropriate for the provider and your workflow.

For a Mailtrap sandbox example, the non-secret server settings are:

host: sandbox.smtp.mailtrap.io
port: 2525
auth:
  user: ${SMTP_USERNAME}
  pass: ${SMTP_PASSWORD}

Keep SMTP_USERNAME and SMTP_PASSWORD in a secret manager or enter them directly in the authenticated form. Do not commit their values to this guide or a video job. A sandbox is for testing; use the provider's production SMTP settings only after confirming the sender domain and delivery configuration.

The live form also asks for an email address. Use the sender address required by the SMTP provider. Verify the provider name, host, port, username, email, and password before saving.

Review and maintain connections​

After saving, confirm the connection appears under the intended Business or Personal tab. If it needs reauthorization, follow the provider sign-in flow. Remove or replace a connection only after checking which users or workflows depend on it.

Troubleshooting​

  • If an integration is missing, check the selected tab, account type, enabled modules, and your permissions.
  • If provider authorization fails, confirm the correct external account is being used and that the provider has not revoked access.
  • For SMTP errors, check the server, port, username, sender email, and password against the provider's current settings. Never share passwords in support screenshots or recordings.
  • If email delivery works but replies are not tracked as expected, review the Reply Tracking option and the provider's reply-handling behavior.