# Generating App Key

To ensure the authenticity of interactions between your web app and Truecaller, you need to generate an app key \[ partner key ] from Truecaller developer account ( <https://developer.truecaller.com/login> ) by adding your app name, domain and a callback URL.

To generate a new app key for your mobile website, go to the 'MANAGE APPS' section on the developer account dashboard and click on 'CREATE APP'. Select 'Web' in the App type and continue to enter your app details.

<figure><img src="https://3916632365-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJzE3kcOEptTlnx7Hgg25%2Fuploads%2FvpemJUkSScjqXIUld3DV%2FF.avif?alt=media&#x26;token=5c033355-ff83-4a8b-95af-d01d4f11bbfd" alt=""><figcaption></figcaption></figure>

*App domain* corresponds to the domain link of your website

*Callback URL* corresponds to an endpoint on your backend where we will post the access token for you to fetch the user's profile. Every access token can be used to fetch the profile only of the related user granting the authorization to your app.

{% hint style="info" %}
When setting up the callback URL, please consider the following:

**Method:** All access token requests will be submitted as POST request. Make sure your service is async, since we only expect that the message is accepted from your side. The service should respond within maximum 3 seconds upon receiving the request.

Each access token has a time-to-live (10 minutes) and if not used within the TTL, the user needs to re-trigger the authorization process from the beginning.

**Security:** To ensure security and privacy, HTTPS should be used. Make sure your certificate is always valid.

**Request Params:**
{% endhint %}

| **Param \[String]**   | **Mandatory** | **Description** | **Example value**                                                |
| --------------------- | ------------- | --------------- | ---------------------------------------------------------------- |
| requestId \[String]   | yes           |                 | vXbyFPwqiCAHZyxAldA9M9DDXKk=                                     |
| accessToken \[String] | yes           |                 | a3sAB0KnGANg4VZwIXfhUyFmPbzoONofl4FjIItac0JQSODp6niW8oBr33uOI-u7 |

{% hint style="info" %}
**Expected Response Codes:**

* 2\*\* OK
  {% endhint %}

Once you input your app details and create the app, you will be able to see a unique "appKey" for your app which you need to include in your project to authorise all verification requests.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.truecaller.com/truecaller-sdk/mobile-websites/generating-app-key.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.