---
schema_version: "1"
id: ca76c52d7e5e705576cdba4c9ec244a1bafecfd0ed0af374f5a1894d1db3b56d
title: Version 2
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/mc_overview_ts_resolve_token_api_v2.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mc_overview_ts_resolve_token_api_v2.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: c3389f69a17dce1ad53974cde6ec8c40087dc83557a8b646cbfed6f73d91f37d
description: Review this information when implemented a Resolve Token API for Tokenized Sending in Marketing Cloud Engagement.
products:
  - Marketing
  - Marketing Cloud Engagement
release: "264"
---
# Version 2

Review this information when implemented a Resolve Token API for Tokenized Sending in Marketing Cloud Engagement.

This request supports HTTP basic authentication. Provide login credential when you set up an account, and use SSL connection to encrypt the usernames or passwords. You can also use OAuth2 with the client\_credentials grant type.

## JSON Response Body Format

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:20%">
          <col style="width:20%">
          <col style="width:20%">
          <col style="width:20%">
          <col style="width:20%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="vertical-align:top;" id="d57738e54">Name</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d57738e57">Type</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d57738e60">Required</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d57738e63">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Name" class="slds-cell-wrap" rowspan="5" style="vertical-align:top;" headers="d57738e54 ">resolvedTokens</td>

            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e54 ">None</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e57 ">array</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e60 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e63 "> Array of ResolvedToken objects</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" colspan="4" style="vertical-align:top;" headers="d57738e54 d57738e57 d57738e60 d57738e63 ">Each resolvedTokens object contains these
              properties:</td>

          </tr>
          <tr class="">
            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e54 ">tokenRequestId</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e57 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e60 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e63 ">UUID generated per token during the request</td>

          </tr>
          <tr class="">
            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e54 ">tokenValue</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e57 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e60 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e63 ">The resolved email address or phone number. You can also call this value email for
              backwards compatibility.</td>

          </tr>
          <tr class="">
            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e54 ">attributes</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e57 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e60 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e63 ">Array of attributes associated with the resolved email address or phone number,
              presented in name and value pairs</td>

          </tr>
          <tr class="">
            <td data-label="Name" class="slds-cell-wrap" rowspan="4" style="vertical-align:top;" headers="d57738e54 ">unresolvedTokens</td>

            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e54 ">None</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e57 ">array</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e60 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e63 ">Array of UnresolvedToken objects</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" colspan="4" style="vertical-align:top;" headers="d57738e54 d57738e57 d57738e60 d57738e63 ">Each unresolvedTokens array contains these
              properties:</td>

          </tr>
          <tr class="">
            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e54 ">tokenRequestId</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e57 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e60 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e63 ">UUID generated per token during the request</td>

          </tr>
          <tr class="">
            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e54 ">message</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e57 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e60 ">No</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e63 ">Error message indicating the cause of the unresolved token</td>

          </tr>
        </tbody>
      </table>

## HTTP Response Examples

The examples include response body with email addresses and attributes, response body with email addresses only, and response body with phone numbers.

## Response Body with Email Addresses and Attributes

```
{
    "resolvedTokens": [
        {
            "tokenRequestId":"abc123thn567",
            "tokenValue": "user1@exacttarget.com",
            "attributes": [
                {
                    "name": "FirstName",
                    "value": "Alice"
                },
                {
                    "name": "LastName",
                    "value": "Smith"
                }
            ]
        },
        {
            "tokenRequestId":"abc098thn654",
            "tokenValue ": "user2@gmail.com",
            "attributes": [
                {
                    "name": "FirstName",
                    "value": "John"
                },
                {
                    "name": "LastName",
                    "value": "Smith"
                }
            ]
        }
    ],
    "unresolvedTokens": []
}
```

## Response Body with Email Addresses

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-mc_marketing_cloud_overview-264-0-0-production-enus/2555afdb-8049-4e3c-8043-0e04803e5f16/images/icon_note.png)

Note Not supported by MobileConnect.

```
{
    "resolvedTokens": [
        {
            "tokenRequestId":"abc123thn567",
            "tokenValue": "user2@gmail.com"
        }
    ],
    "unresolvedTokens": [
        {
            "tokenRequestId":"abc098thn654",
            "message": "Invalid token; token does not exist." 
        }
    ]
}
```

## Response Body with Phone Numbers

```
{
    "resolvedTokens": [
        {
            "tokenRequestId":"abc123thn567",
            "tokenValue": "13175551212"
        }
    ],
    "unresolvedTokens": [
        {
            "tokenRequestId":"abc098thn654",
            "message": "Invalid token; token does not exist." 
        }
    ]
}
```

## JSON Request Body Format

The JSON Request Body Format includes a valid JSON object (application/json content type) with these properties.

New Users must use Version 2 of the specification.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:20%">
          <col style="width:20%">
          <col style="width:20%">
          <col style="width:20%">
          <col style="width:20%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="vertical-align:top;" id="d57738e269">Name</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d57738e272">Type</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d57738e275">Required</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d57738e278">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Name" class="slds-cell-wrap" rowspan="5" style="vertical-align:top;" headers="d57738e269 ">tokens</td>

            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e269 ">None</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e272 ">array</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e275 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e278 ">Array of token objects</td>

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" colspan="4" style="vertical-align:top;" headers="d57738e269 d57738e272 d57738e275 d57738e278 ">Each tokens object contains an array of these
              objects:</td>

          </tr>
          <tr class="">
            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e269 ">tokenRequestId</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e272 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e275 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e278 ">UUID generated per token</td>

          </tr>
          <tr class="">
            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e269 ">token</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e272 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e275 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e278 ">Email address or mobile number token to resolve</td>

          </tr>
          <tr class="">
            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e269 ">subscriberKey</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e272 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e275 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e278 ">Subscriber key or contact key value associated with the token to resolve</td>

          </tr>
          <tr class="">
            <td data-label="Name" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e269 ">sendKey</td>

            <td data-label="Type" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e269 ">None</td>

            <td data-label="Required" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e272 ">string</td>

            <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e275 ">Yes</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57738e278 ">
              <ul>
                <li>Mobile message name value for the currently sending SMS message </li>

                <li>Customer key value for the user-initiated email </li>

                <li>Customer key value for the triggered send email</li>

              </ul>
            </td>

          </tr>
        </tbody>
      </table>

## Example with Email Addresses

```
{
    "tokens": [
        {
            "tokenRequestId":"abc123thn567",
"token":"t1234@example.com",
            "subscriberKey":"12345abcde67890fghij"
        },
        {
            "tokenRequestId":"abc098thn654",
"token":"t5678@example.com",
            "subscriberKey":"1111155555aAaAabBbBb"
        }
    ],
    "sendKey": "ExampleEmail_12345"
}
```

## Example with Phone Number

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-mktg-mc_marketing_cloud_overview-264-0-0-production-enus/2555afdb-8049-4e3c-8043-0e04803e5f16/images/icon_note.png)

Note MobileConnect does not support this functionality.

```
{
    "tokens": [
        {
            "tokenRequestId":"abc123thn567",
"token":"012345678901234",
            "subscriberKey":"12345abcde67890fghij"
        },
        {
            "tokenRequestId":"abc098thn654",
"token":"012345678901235",
            "subscriberKey":"1111155555aAaAabBbBb"
        }
    ],
    "sendKey": "ExampleEmail_12345"
}
```