# Create Token

## Create Token

<mark style="color:green;">`POST`</mark> `https://vx-be.idresponse.com/token/create`

This endpoint creates your token with associated settings to access a document iFrame session.

#### Request Body

| Name                                   | Type   | Description                                          |
| -------------------------------------- | ------ | ---------------------------------------------------- |
| user<mark style="color:red;">\*</mark> | string | Your Veratad API username                            |
| pass<mark style="color:red;">\*</mark> | string | Your Veratad API Password                            |
| journey\_id                            | String | The VX journey ID to be loaded with this token       |
| settings\_id                           | String | The settings profile ID to be loaded with this token |
| branding\_id                           | String | The branding ID to be loaded with this token         |

{% tabs %}
{% tab title="200 Token successfully created." %}

```
{
    "result": "Success",
    "message": "Token created successfully",
    "token": "393d50f9-2703-4100-9e4b-dfd8e4fda493",
    "age": "21+",
    "rules": "DCAMS5_0_RuleSet_NAME_DOB",
    "store_on": "FAIL",
    "company_name_for_email": "Company ABC",
    "email_logo_link": "https://yourcompany.com/logo.png",
    "email_logo_height": "50",
    "email_logo_width": "80",
    "dcams_manual_rules": "DCAMS5_0_Manual_Review_RuleSet_NAME_DOB"
}
```

{% endtab %}

{% tab title="400 Missing a required input" %}

```
{
    "result": "Error",
    "message": "Missing a required input",
    "token": ""
}

{
    "result": "Error",
    "message": "Invalid age submitted. Must conform to age+ like 21+",
    "token": ""
}

{
    "result": "Error",
    "message": "Invalid ruleset submitted. Please check the documentation",
    "token": ""
}

{
    "result": "Error",
    "message": "Invalid store_on value. Must be PASS, FAIL or ALL",
    "token": ""
}
```

{% endtab %}

{% tab title="401 Username or password is incorrect." %}

```
{
    "result": "Error",
    "message": "Either your username or password is incorrect",
    "token": ""
}
```

{% endtab %}
{% endtabs %}

{% hint style="info" %}
**IMPORTANT:** The token is only good for 6 hours. It is recommended that you generate a new token on each iFrame request.
{% endhint %}

## Request Body

```json
{
    "user": "USERNAME | API KEY",
    "pass": "PASSWORD",
    "journey_id": "SET | DEFAULT", 
    "settings_id": "SET | DEFAULT", 
    "branding_id": "SET | DEFAULT"
}
```