---
sourceDocument: Australia Conversational Interfaces
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/conversational-interfaces

 Release :

    - australia

ft:locale :

    - pt-BR

ft:publication_title :

    - Australia Conversational Interfaces

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# OAuth setup for Apple Messages for Business

# OAuth setup for Apple Messages for Business {#ariaid-title1}

* Versão de lançamento: Australia
* 
* Atualizado 12 de mar. de 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 min. de leitura

Integrate your Identity Provider (IdP) with Apple Messages for Business using OAuth2 authentication.

## Connect Apple Messages for Business to your ServiceNow® instance {#oauth-setup-apple__prereq_xsd_gzr_kxb}

Complete the following steps on the Apple Messages for Business site to connect your Apple Messages for Business account to your ServiceNow® instance.

1. Go to the Apple Messages for Business page (register.apple.com) and log in to your Messages for Business account.
2. Go to the Integrated OAuth2 Authentication section.
3. Add the Authorization URL from your Identity Provider (IdP) to the OAuth URL field.
4. Add the Token URL from your IdP to the Token URL field.
5. Add the Client ID from your IdP to the Client Identifier field.
6. Refer to the [Apple documentation](https://register.apple.com/resources/messages/msp-rest-api/type-interactive#authentication-message) for further instructions on configuring OAuth2 authentication on your Apple Messages for Business account.
{#oauth-setup-apple__steps_lfn_bzr_kxb}

## Set up OAuth on your ServiceNow® instance {#oauth-setup-apple__section_zgh_5bs_kxb}

1. Go to your ServiceNow® instance to set up OAuth.
2. Create a new record in the Application Registries (oauth_entity) table using these instructions: [Use a third-party OAuth provider](https://www.servicenow.com/docs/access?context=t_UseAThirdPartyOAuthProvider&version=australia&pubname=australia-api-reference&ft:locale=en-US).
   * Use the grant type Authorization code.
   * Add the Token URL.
   {#oauth-setup-apple__ul_t35_5hc_yxb}
3. Create a new record in the OAuth Entity Scopes (oauth_entity_scope) table using these instructions: [Specify an OAuth scope](https://www.servicenow.com/docs/access?context=t_SpecifyAnOAuthScope&version=australia&pubname=australia-api-reference&ft:locale=en-US). If you have multiple scopes, then add a new record for each scope, and create a corresponding Entity Profile Scope record for each scope.
4. Create a new record in the Connection and Credential Aliases (sys_alias) table using these instructions: [Create a Connection \& Credential alias](https://www.servicenow.com/docs/access?context=connection-alias&version=australia&pubname=australia-platform-security&ft:locale=en-US). This connection alias is used for fetching the http connection record which you create in the next step.
5. Create a new record in the HTTP(s) Connection (http_connection) table using these instructions: [Create an HTTP(s) connection](https://www.servicenow.com/docs/access?context=create-https-connection&version=australia&pubname=australia-platform-security&ft:locale=en-US).
   * Type of connection - Select HTTP(s) Connection
   * Set the Connection alias to the <kbd class="ph userinput">sys_alias</kbd> record created in previous step.

   * Set the connection url to fetch the user information API as per your IdP. (For example:<kbd class="ph userinput"> https://&lt;your-idp-app&gt;.com/api/v1/users</kbd>)
   {#oauth-setup-apple__ul_fgg_vz5_gxb}
6. Create a Profile Parser Action using Workflow Studio. See the code snippets shown here for an example: [Create a profile parser action for Apple Messages for Business](https://servicenow-prod.fluidtopics.net/ECmxLgsIFjeiPrQow6KJ4Q "Create an action to parse the user information response and find the corresponding user on the ServiceNow instance for Conversational Integration with Apple Messages for Business using the information provided here."). See [Building actions](https://www.servicenow.com/docs/access?context=actions&version=australia&pubname=australia-build-workflows&ft:locale=en-US) for more details.
7. Create a new record in the Provider Application Authentications (sys_cs_provider_app_authentication) table using these instructions:
   * Set the Provider Channel Identity to your provider app (<kbd class="ph userinput">sys_cs_provider_application</kbd>)
   * Set the OAuth Entity Profile to the <kbd class="ph userinput">oauth_entity_profile</kbd> record created with your OAuth Provider (<kbd class="ph userinput">oauth_entity</kbd>) record.
   * Set the Profile API Connection to the <kbd class="ph userinput">http_connection</kbd> record created previously.

   * Set the Profile Response Parser Action to the <kbd class="ph userinput">sys_hub_action_type_definition</kbd> record that you have defined.
   {#oauth-setup-apple__ul_k2q_11v_gxb}
{#oauth-setup-apple__ol_blf_xbs_kxb}