Provision a User Extension and Send the Welcome Email
A 3-step recipe with RingCentral. We can help you get access.
Recipe · 3 steps
Provision a User Extension and Send the Welcome Email
with RingCentral
Create a user extension, verify its state, and send the activation welcome email.
- Create the extension with the user's contact record. The extension is created in the NotActivated state until the user completes activation.
- Read the extension back to confirm what RingCentral actually provisioned — the allocated extension number, the contact record, and the activation state the user is currently in.
- Send the welcome/activation email to the new user. This operation lives on the v2 provisioning surface and is account-scoped, taking the target address in the body rather than an extension id in the path.
What you'll need to have ready
- accountId: Internal identifier of the RingCentral account. Use "~" for the account associated with the current authorization session.
- firstName: First (given) name of the user.
- lastName: Last (family) name of the user.
- email: The user's email address. Activation and welcome mail is delivered here.
- extensionNumber: The extension number to assign. Omit to let RingCentral allocate the next available number.
- jobTitle: Job title recorded on the extension's contact record.
- department: Department recorded on the extension's contact record.
- emailAsLoginName: Whether the user's email address doubles as their login name.
- extensionType: The type of extension to create (e.g. User, Department, Announcement).
For your developer
Arazzo workflow ringcentral:provision-extension-send-welcome, 3 operations: createExtension → readExtension → sendWelcomeEmailV2. Specs on APIs.io.