Salesforce OneCRM GraphQL API

Overview

Please follow the instructions below to use the Salesforce OneCRM GraphQL API.

Getting Started

1. Register/Login to the Developer Portal.
2. Subscribe to the Product and obtain a Subscription Key.
3. Navigate to the Developer Portal:
   https://qa-apihub.nttltd.global.ntt
4. Sign in using your Entra ID account.
5. Select the API/Product.
6. Subscribe to the Product.
7. Go to Profile add Subscriptions.
8. Copy the Subscription Key.

Use the Subscription Key in your request headers:

ocp-apim-subscription-key: your_subscription_key

Authentication

Generate an OAuth 2.0 Bearer Token using the following endpoint:

Postman Request Settings

Method: POST

Body (x-www-form-urlencoded)

grant_type=client_credentials
client_id=your_client_id
client_secret=your_client_secret
scope=api://a2e8b53a-8d19-4841-a59a-4671ca3fdf49/.default

Create GraphQL Request in Postman

1. Create a new GraphQL request in Postman.
2. Generate the OAuth token using the Authentication step above.
3. Under Authorization, select Bearer Token.
4. Paste the generated access token.
5. Add the Subscription Key header.
6. Use the API endpoint below.

Required Headers

Authorization: Bearer your_access_token
ocp-apim-subscription-key: your_subscription_key
Content-Type: application/json

Environment Endpoints

Common Query Examples

Get Account

query {
  account(id: "001XX000003ABC") {
    id
    name
    industry
  }
}

Get Customer Details

query {
  customer(id: "12345") {
    name
    email
    phone
  }
}

Get Contacts

query Uiapi {
  uiapi {
    query {
      Contact(first: 10) {
        totalCount
        pageResultCount
        edges {
          cursor
          node {
            Id
            ApiName
            WeakEtag
            DisplayValue
          }
        }
      }
    }
  }
}