NetSuite and Twilio integrate through NetSuite SuiteScript 2.0 and the Twilio REST API to send SMS directly from NetSuite record events including new sales orders, invoice creation, shipment dispatch, and payment receipt, enabling ERP-driven SMS notifications that keep customers and internal teams informed without any middleware or third-party connector. This integration is used by manufacturing, distribution, and wholesale businesses running NetSuite as their ERP who want to add SMS order confirmation, shipment tracking notification, and overdue invoice reminders as automated workflows triggered directly by NetSuite record changes. The connection uses a NetSuite SuiteScript User Event script that fires on record create or update events and makes an outbound HTTPS callout to the Twilio Messages API using NetSuite's N/https module.
What You Need Before You Start
Confirm that your NetSuite account has SuiteScript 2.0 enabled and that outbound HTTP callouts are permitted by navigating to Setup, then Company, then Enable Features, and checking that the SuiteScript checkbox is enabled under the SuiteCloud tab. Store your Twilio Account SID, Auth Token, and From Number as NetSuite Custom Fields on a Configuration custom record type by creating a Configuration record type at Customization, then Lists, Records, and Fields, then Record Types, adding text fields for TwilioAccountSid, TwilioAuthToken, and TwilioFromNumber, creating one configuration record with your values, and retrieving them in SuiteScript using search.lookupFields. Add the Twilio API domain to NetSuite's allowed HTTPS callout domains by navigating to Setup, then Company, then Allowed Domains for HTTP Client Calls, and adding api.twilio.com to the allowed list, as NetSuite requires explicit domain allowlisting before SuiteScript can make outbound HTTPS calls. From Twilio, provision an SMS-capable phone number and complete A2P 10DLC registration in the Twilio Console for US-bound transactional messaging.
Step-by-Step Integration Guide
Create a SuiteScript 2.0 User Event script file named twilioSmsOnOrderCreate.js with the following structure: define(['N/https', 'N/encode', 'N/search', 'N/record'], function(https, encode, search, record) { function afterSubmit(context) { if (context.type !== context.UserEventType.CREATE) return; var order = context.newRecord; var customerId = order.getValue('entity'); var custRecord = record.load({ type: record.Type.CUSTOMER, id: customerId }); var phone = custRecord.getValue('mobilephone'); if (!phone) return; var config = search.lookupFields({ type: 'customrecord_twilio_config', id: 1, columns: ['custrecord_account_sid', 'custrecord_auth_token', 'custrecord_from_number'] }); var accountSid = config.custrecord_account_sid; var authToken = config.custrecord_auth_token; var fromNumber = config.custrecord_from_number; var body = 'Order ' + order.getValue('tranid') + ' confirmed. Total: $' + order.getValue('total') + '. Thank you for your business.'; var params = 'To=' + encodeURIComponent(phone) + '&From=' + encodeURIComponent(fromNumber) + '&Body=' + encodeURIComponent(body); var credentials = encode.convert({ string: accountSid + ':' + authToken, inputEncoding: encode.Encoding.UTF_8, outputEncoding: encode.Encoding.BASE_64 }); https.post({ url: 'https://api.twilio.com/2010-04-01/Accounts/' + accountSid + '/Messages.json', body: params, headers: { 'Authorization': 'Basic ' + credentials, 'Content-Type': 'application/x-www-form-urlencoded' } }); } return { afterSubmit: afterSubmit }; }); Upload the script to NetSuite by navigating to Customization, then Scripting, then Scripts, clicking New, uploading the JavaScript file, and setting the Script Type to User Event, then create a Script Deployment targeting the Sales Order record type with the After Submit event enabled. Test the script by creating a new Sales Order in NetSuite for a customer with a mobile phone number on file and checking the Twilio Console message log for the dispatched SMS.
Common Issues and How to Fix Them
NetSuite SuiteScript HTTPS callouts to the Twilio API fail with an SSS_DISALLOWED_URL error when api.twilio.com has not been added to the allowed HTTPS domains in the NetSuite Setup configuration, which prevents all outbound SuiteScript HTTP calls to domains not on the allowlist. Navigate to Setup, then Company, then Allowed Domains for HTTP Client Calls, add api.twilio.com as an allowed domain, save the configuration, and redeploy the SuiteScript without changes to pick up the new domain allowlist. The customer's mobile phone field in NetSuite may be empty, formatted with local numbers without a country code, or contain extension numbers appended with an x character, all of which cause the Twilio API to reject the To parameter with a 21211 error. Add phone validation in the SuiteScript by checking that the phone value is not null or empty, stripping non-digit characters except for the leading plus sign, prepending +1 for US numbers shorter than 11 digits, and skipping the Twilio callout entirely when the phone cannot be normalized to a valid E.164 format. SuiteScript User Event scripts run synchronously during the NetSuite record save, and if the Twilio API is slow to respond the NetSuite user experiences a slow page load waiting for the script to complete. Move the Twilio callout to a NetSuite Scheduled Script or Map/Reduce Script by having the User Event script write the SMS request to a custom SMS Queue record, and running a Scheduled Script every 5 minutes that reads pending queue records, dispatches Twilio SMS for each, and marks them as sent, decoupling the SMS send from the synchronous record save workflow.
How to Get More from This Integration
Build a NetSuite invoice reminder SMS workflow by creating a SuiteScript Scheduled Script that runs daily at 08:00, searches the Invoice record type for invoices where Status is Open and DueDate is equal to today plus 7 days or today, loads each invoice record to retrieve the customer mobile phone, and dispatches a Twilio SMS reminder with the invoice number, amount due, and a payment link constructed from your customer portal URL concatenated with the invoice ID. Add a shipment notification SMS by attaching a User Event script to the Item Fulfillment record type that fires on record creation, extracting the related Sales Order number and the customer phone from the linked customer record, and dispatching a Twilio SMS informing the customer that their order has shipped with the fulfillment record's tracking number if available in a custom field. Create an internal operations SMS alert by adding a second SMS dispatch in your User Event script that fires when an order exceeds a dollar threshold, dispatching a Twilio SMS to the sales manager's phone stored in the NetSuite Employee record for that customer's assigned sales rep, alerting the manager to high-value orders immediately upon creation. Extend the integration with a two-way SMS reply handler by exposing a NetSuite RESTlet as a public webhook endpoint that receives inbound Twilio SMS payloads, looks up the customer by phone number using a saved search against the Customer record, and creates a new NetSuite Case or Customer Message record from the inbound SMS text, building a complete inbound SMS-to-ERP case management workflow.
Conclusion
NetSuite SuiteScript and Twilio together bring ERP-triggered SMS notifications directly from your order, invoice, and shipment records without requiring any external middleware or additional subscriptions. Get in touch with Telphi Consulting to build and deploy a NetSuite Twilio SMS SuiteScript integration for your ERP workflows.
Ready to Transform Your Business Communications?
Get a free consultation with our VoIP experts and discover how we can help you save costs, improve efficiency, and scale your business.
Comments (0)
Join the discussion and share your thoughts (AI-moderated for quality)
Be the first to comment
No comments yet. Share your thoughts below.