📘

For step-by-step instructions on how to use this endpoint to create a public integration, check out theAuthorization guide. To walkthrough how to create tokens for Link Previews, refer to theLink Previews guide.

🚧

Redirect URI requirements for public integrations

Theredirect_uri is arequired field in the request body for this endpoint if:

• theredirect_uri query parameter was set in theAuthorization URL provided to users,or;
• there are more than oneredirect_uris included in theintegration’s settings underOAuth Domain & URIs.

In most cases, theredirect_uri field is required.

This field is not allowed in the request body if:

• there is oneredirect_uri included in theintegration’s settings underOAuth Domain & URIs,and theredirect_uri query parameter was not included in the Authorization URL.

Learn more in the public integration section of theAuthorization Guide.

Note: Each Public API endpoint can return several possible error codes. To see a full description of each type of error code, see theError codes section of the Status codes documentation.