> For the complete documentation index, see [llms.txt](https://docs.etelecom.vn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.etelecom.vn/api-etelecom-english/api-integration/zalo-cloud/zalo-cloud-api/create-oa-authorization-link.md).

# Create OA authorization link

This API is used to get the OA authorization path for the application (app).

{% hint style="info" %}
**Note:**

* For APIs used for Shop, the API key is: [`<api_key>`](/api-etelecom-english/api-integration/shop/account.md). The base\_url information of the [Shop](/api-etelecom-english/api-integration/shop/account.md).
* For APIs used for Partner, the API key is: [`<shop_key>`](/api-etelecom-english/api-integration/partner/usage.md#retrieve-the-shop_key-information). The base\_url information of the [Partner](/api-etelecom-english/api-integration/partner/account.md).
  {% endhint %}

{% openapi src="/files/98tvgFAALfk6gcxXW2re" path="$BASE\_URL.Zalo/AuthorizeOA" method="post" %}
[Etelecom.swagger.json](https://1712041776-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FzzTMjVbVjwTuSbEGC7Ya%2Fuploads%2Fgit-blob-a79f1cdcdf6c0710885851e38f1e6c641fafb69b%2FEtelecom.swagger.json?alt=media)
{% endopenapi %}

**Request:**

```json
curl --location '$BASE_URL.Zalo/AuthorizeOA' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer $API_KEY' \
--data '{
  "app_id": "int64",
  "app_secret": "string",
  "redirect_uri": "string"
}'
```

**Response:**

```json
{
  "url": "string"
}
```

**Request body structure**

| Parameters  | Data type | Describe                                                                                                |
| ----------- | --------- | ------------------------------------------------------------------------------------------------------- |
| app\_id     | int64     | Application ID                                                                                          |
| app\_secret | string    | Application secret key                                                                                  |
| redirects   | string    | The callback URL is set in "Official Account Callback Url" on the app <https://developers.zalo.me/apps> |

**Return data attribute structure**

<table><thead><tr><th width="165">Parameters</th><th width="139">Data type</th><th>Describe</th></tr></thead><tbody><tr><td>url</td><td>string</td><td>OA authorization link for the application</td></tr></tbody></table>