Before you start
Create a BulkSMS API token
Log in to your BulkSMS account and go to Settings > Developers.
Click Create API Token and give it a name, for example Novu. Copy the Token ID and Token Secret. The secret is only shown once.
Add BulkSMS in Novu
In the Novu dashboard, go to Integrations > Add a provider > SMS > BulkSMS and click Next.
Choose the environment and click Create.
Switch the integration from Disabled to Active and fill in:
- API Token: your Token ID and Token Secret joined by a colon, for example
ABC123:secretvalue. - Sender ID: optional. A number or a registered alphanumeric Sender ID.
The API Token field needs both values joined with a colon. Entering only the Token ID or only the secret won't work.
Click Update, then trigger a workflow with an SMS step to your own number to test.
Troubleshooting
Authentication errors: check the API Token is in TokenID:TokenSecret format, with no spaces.
Messages aren't delivered: check subscribers' phone numbers are in international format and that your account has credits. Look for the message under Sent Messages in BulkSMS.
All setup and ready to go!
If you have any questions, please contact our support team. Include your account name and put Novu in the subject line, and we'll be happy to help.
See also Novu's BulkSMS integration docs.