Connecting Your Account to an SMS Provider

Connect FORMEPIC to your preferred SMS service for reliable text message delivery #

FORMEPIC integrates seamlessly with leading SMS providers worldwide, giving you the freedom to choose the service that best matches your geographic reach, pricing structure, and feature requirements. Whether you’re sending a handful of confirmation texts or managing high-volume campaigns, our flexible provider system lets you work with trusted platforms like Twilio, Vonage, MessageBird, and others to deliver messages reliably across the globe.

Setting up your SMS provider takes just minutes—simply add your API credentials to FORMEPIC, and you’re ready to start sending personalized SMS notifications, autoresponders, and digests directly from your forms. With support for multiple providers simultaneously, you can optimize for different regions, purposes, or client needs while managing everything from one unified dashboard.

Requirements #

• Active Account: An active account with one of the supported SMS providers
• API Credentials: Access to your provider’s API keys, tokens, or authentication credentials
• Verified Phone Number: A phone number verified with your provider for sending messages
• Sufficient Balance: Adequate credits or balance in your provider account to send messages
• API Permissions: Ensure your API credentials have permission to send SMS messages

Supported SMS Providers #

FORMEPIC supports integration with the following SMS providers:

Global Providers #

Twilio

• Industry-leading SMS platform with global coverage
• Excellent documentation and developer support
• Competitive pricing with pay-as-you-go model
• Required credentials: Account SID, Auth Token

Vonage (Nexmo)

• Strong international reach with competitive rates
• Robust API with advanced features
• Good delivery rates worldwide
• Required credentials: API Key, API Secret

MessageBird

• European-based provider with global reach
• Simple API and competitive pricing
• Strong presence in Europe and Asia
• Required credentials: API Key

Plivo

• Cost-effective alternative with good coverage
• Easy-to-use API and dashboard
• Strong focus on voice and SMS
• Required credentials: Auth ID, Auth Token

Telnyx

• Carrier-grade infrastructure with real-time delivery
• Competitive pricing and transparent billing
• Global coverage with local numbers
• Required credentials: API Key

Sinch

• Enterprise-grade messaging platform
• Excellent delivery rates and global reach
• Advanced analytics and reporting
• Required credentials: Service Plan ID, API Token

Regional Specialists #

Africa’s Talking

• Specialized coverage across African countries
• Local payment options and support
• Excellent regional delivery rates
• Required credentials: Username, API Key

Infobip

• Enterprise messaging platform with global reach
• Strong presence in Europe and EMEA
• Advanced features for large-scale campaigns
• Required credentials: API Key, Base URL

How to Add an SMS Provider #

1. Navigate to Form Builder: Open the form where you want to enable SMS
2. Access Settings: Click the “Settings” icon in the left sidebar
3. Find SMS Section: Scroll down to the SMS settings section
4. Click “Add SMS Provider”: Click the button to open the provider configuration dialog
5. Select Provider Type: Choose your SMS provider from the dropdown menu
6. Name Your Configuration: Enter a descriptive name (e.g., “Twilio Production” or “MessageBird EU”)
7. Enter Credentials: Fill in the required credentials for your chosen provider
8. Save Provider: Click “Save Provider” to securely store your configuration

Provider-Specific Setup Guides #

Setting Up Twilio #

1. Create Twilio Account: Sign up at twilio.com
2. Get Phone Number: Purchase or set up a phone number in the Twilio Console
3. Find Credentials: Go to Console Dashboard to find your Account SID and Auth Token
4. Copy to FORMEPIC:

• Account SID: Located at the top of your Twilio Console
• Auth Token: Click to reveal and copy from Console

1. Verify Setup: Send a test message to confirm configuration

Setting Up Vonage (Nexmo) #

1. Create Vonage Account: Sign up at vonage.com/communications-apis
2. Get API Credentials: Navigate to “API Settings” in your dashboard
3. Copy Credentials:

• API Key: Your unique API key
• API Secret: Your secret key (keep this secure)

1. Configure Sender: Set up your sender ID or phone number
2. Test Connection: Verify by sending a test SMS

Setting Up MessageBird #

1. Create MessageBird Account: Sign up at messagebird.com
2. Generate API Key: Go to Developers > API Keys in your dashboard
3. Create Live Key: Generate a new “Live” API key (not Test key)
4. Copy to FORMEPIC: Enter your API key in FORMEPIC’s provider configuration
5. Add Sender ID: Configure your sender ID or phone number in MessageBird

Setting Up Plivo #

1. Create Plivo Account: Sign up at plivo.com
2. Get Phone Number: Purchase a phone number for sending
3. Find Credentials: Go to Account Settings
4. Copy Credentials:

• Auth ID: Your Plivo Auth ID
• Auth Token: Your Plivo Auth Token

1. Test Integration: Send a test message to verify setup

Setting Up Telnyx #

1. Create Telnyx Account: Sign up at telnyx.com
2. Generate API Key: Navigate to API Keys in your dashboard
3. Create New Key: Generate a new API key with messaging permissions
4. Copy to FORMEPIC: Enter your API key
5. Configure Number: Set up your messaging profile and phone number

Setting Up Sinch #

1. Create Sinch Account: Sign up at sinch.com
2. Create Service Plan: Set up a messaging service plan
3. Get Credentials:

• Service Plan ID: Found in your service plan settings
• API Token: Generated in the API section

1. Copy to FORMEPIC: Enter both credentials
2. Verify Setup: Test message delivery

Setting Up Africa’s Talking #

1. Create Account: Sign up at africastalking.com
2. Choose Countries: Select the African countries you want to send to
3. Get Credentials:

• Username: Your Africa’s Talking username
• API Key: Generated in the API Key section

1. Add to FORMEPIC: Enter your username and API key
2. Test Delivery: Send a test SMS to verify

Setting Up Infobip #

1. Create Infobip Account: Sign up at infobip.com
2. Generate API Key: Navigate to API Keys in your account settings
3. Find Base URL: Note your assigned base URL (e.g., api.infobip.com)
4. Copy to FORMEPIC:

• API Key: Your generated key
• Base URL: Your assigned endpoint

1. Test Connection: Verify with a test message

Managing Multiple Providers #

You can configure multiple SMS providers for different purposes:

Use Cases for Multiple Providers:

• Geographic Optimization: Use regional providers for better rates and delivery in specific areas
• Redundancy: Have backup providers in case of service issues
• Client Separation: Different providers for different client projects
• Cost Optimization: Use cheaper providers for bulk messaging, premium providers for critical alerts
• Testing vs Production: Separate providers for testing and live environments

Switching Between Providers:

1. Each SMS configuration (notification, autoresponder, digest) can use a different provider
2. Select the provider from the dropdown when configuring each SMS type
3. Providers can be enabled/disabled without deleting their configuration
4. All provider credentials are stored securely and encrypted

Tips and Tricks #

• Start with Twilio: If unsure which provider to choose, Twilio offers excellent documentation and support for beginners
• Compare Pricing: Different providers have different pricing models—calculate based on your expected volume and destinations
• Test Both Ways: Send test messages both to and from your region to verify bidirectional capabilities
• Keep Credentials Safe: Store your API keys securely and never share them publicly
• Use Descriptive Names: When adding multiple providers, use clear names like “Twilio-US” or “MessageBird-EU”
• Monitor Usage: Set up billing alerts in your provider dashboard to avoid unexpected charges
• Verify Numbers First: Always verify your sending numbers with the provider before going live
• Check Rate Limits: Different providers have different rate limits—verify yours before high-volume sending
• Read Provider Docs: Each provider has specific features and limitations—review their documentation
• Geographic Coverage: Choose providers with strong coverage in your target regions

Important Notes #

• Credentials Security: Your SMS provider credentials are encrypted and stored securely in FORMEPIC
• No Credential Sharing: FORMEPIC never shares your credentials with third parties
• Provider Costs: All SMS costs are paid directly to your SMS provider, not to FORMEPIC
• Rate Limits: Your provider’s rate limits apply—FORMEPIC doesn’t impose additional limits
• Message Logs: Message delivery logs are available in your provider’s dashboard, not in FORMEPIC
• Provider Status: FORMEPIC cannot control provider outages or service issues
• Credential Changes: If you regenerate API keys with your provider, update them in FORMEPIC immediately
• Multiple Forms: One provider configuration can be used across multiple forms
• Deletion Warning: Deleting a provider removes it from all forms using it—ensure it’s not in use first
• Provider Requirements: Some providers require identity verification or business documentation before activation

Common Issues & Troubleshooting #

Authentication Failed

• Double-check that credentials are copied exactly (no extra spaces)
• Verify you’re using “Live” or “Production” keys, not “Test” keys
• Ensure API keys have messaging permissions enabled
• Try regenerating your API keys from your provider dashboard
• Check if your provider account is active and in good standing

Provider Not Appearing in Dropdown

• Ensure you clicked “Save Provider” after entering credentials
• Refresh the page and try again
• Check browser console for any error messages
• Verify the provider was saved successfully (no error toast)

Messages Not Sending After Provider Setup

• Confirm your provider account has sufficient balance/credits
• Verify your sending phone number is active and verified with the provider
• Check provider dashboard for any account restrictions or holds
• Ensure your provider account doesn’t require additional verification
• Review provider-specific sending requirements (some require opt-in records)

Invalid API Credentials Error

• Log into your provider dashboard and verify credentials are correct
• Check if API keys have expired or been revoked
• Ensure you’re copying the correct credential fields (Account SID vs Auth Token, etc.)
• Look for hidden characters when copying (select carefully)
• Try creating a new API key and updating in FORMEPIC

Provider Connection Timeout

• Check your internet connection
• Verify the provider’s service status (check their status page)
• Try again in a few minutes (temporary network issues)
• Confirm provider API endpoints are accessible from your location

Cannot Delete Provider

• Check if the provider is currently in use by any active SMS configurations
• Disable all SMS using that provider first
• Refresh the page and try deleting again
• Ensure you have the necessary permissions to delete providers

Regional Delivery Issues

• Verify your provider supports sending to the target country
• Check if additional setup is required for international sending
• Some providers require separate permissions for certain regions
• Consider using a regional provider for better coverage

Rate Limiting Errors

• Review your provider’s rate limits in their documentation
• Consider spacing out sends over time for large batches
• Upgrade your provider account if you need higher limits
• Use multiple providers to distribute load