---
schema_version: "1"
id: 32b08ae9c4af610a8104089a69cba71d71fef52acc27d36f9d9ee7113d776a3e
title: Version 1
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_v1.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.mc_overview_ts_resolve_token_api_v1.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 5935373f0fbe6cbb2c7c6b471564fc7283b5ac9c6208efbf0dd9b7a5957126a0
description: Review this information when implemented a Resolve Token API for Tokenized Sending in Marketing Cloud Engagement. New users must use Version 2 of the specifications. Version 1 information is a reference for users with existing implementations.
products:
  - Marketing
  - Marketing Cloud Engagement
release: "264"
---
# Version 1

Review this information when implemented a Resolve Token API for Tokenized Sending in Marketing Cloud Engagement. New users must use Version 2 of the specifications. Version 1 information is a reference for users with existing implementations.

This request supports HTTP basic authentication. Provide login credentials when you set up the account and use SSL connection to encrypt 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="d68789e54">Name</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d68789e57">Type</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d68789e60">Required</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d68789e63">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Name" class="slds-cell-wrap" rowspan="5" style="vertical-align:top;" headers="d68789e54 ">resolvedTokens</td>

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

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

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

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

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" colspan="4" style="vertical-align:top;" headers="d68789e54 d68789e57 d68789e60 d68789e63 ">Each resolvedTokens object contains these
              properties:</td>

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

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

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

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

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

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

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

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d68789e63 ">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="d68789e54 ">attributes</td>

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

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

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d68789e63 ">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="d68789e54 ">unresolvedTokens</td>

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

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

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

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

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" colspan="4" style="vertical-align:top;" headers="d68789e54 d68789e57 d68789e60 d68789e63 ">Each unresolvedTokens array contains these
              properties:</td>

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

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

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

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

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

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

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

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d68789e63 ">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="d68789e269">Name</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d68789e272">Type</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d68789e275">Required</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d68789e278">Description</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Name" class="slds-cell-wrap" rowspan="3" style="vertical-align:top;" headers="d68789e269 ">tokens</td>

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

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

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

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

          </tr>
          <tr class="">
            <td class="slds-cell-wrap" colspan="4" style="vertical-align:top;" headers="d68789e269 d68789e272 d68789e275 d68789e278 ">Each tokens object contains an array of this
              object:</td>

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

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

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

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d68789e278 ">String value containing the token to resolve with information from your data
              system</td>

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

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

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

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

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d68789e278 ">External key for send definition used by message. This property uses the name of the
              email in the send if the send doesn’t use an email send definition.</td>

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

## Example with Email Addresses

```
{
    "tokens": [
        {
            "token":"t1234@example.com"
        },
        {
            "token":"t5678@example.com"
        }
    ],
    "sendKey": "ExampleEmailSend_12345" 
}
```

## Example with Phone Number

```
{
    "tokens": [
        {
            "token":"+353.1234"
        },
        {
            "token":"+353.5678"
        }
    ], 
    "sendKey": "ExampleMessage_12345"
}
```