---
title: "Add an integration"
slug: "integration-settings-v2integration-settings-1"
updated: 2025-11-17T08:10:53Z
published: 2025-11-17T08:12:09Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.gong.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration Settings (/v2/integration-settings)

Post/v2/integration-settings

Required authorizaton scope: 'api:integration-settings:write'.

Body parameters<select class='api-response-data' aria-label='Media type'><option value='82565589-e2a0-494f-9e6b-175b723f0494'>application/json</option>
</select>Expand Allobject  

Integration settings metadata

integrationTypeSettings Array of object (IntegrationTypeSettings)   Required

Set a list of dynamic origins for a company

object  

Set a list of dynamic origins for a company

integrationTypestring    Required

The integration type in Gong

Valid values[
  "EMAIL_COMPOSER",
  "ACCOUNT_PAGES",
  "DIALER"
]
allowedOriginstring    Required

A valid origin that can be used as the iFrame source. Use this to add tenant sub domains as valid for the integration. For example, if you create dynamic domains for your customers eg [https://acme.partner.com](https://acme.partner.com)

Responses200

Successful response

<select class='api-response-data' aria-label='Media type'><option value='a2ed4dbc-5ffa-4cb1-80cc-35657f685398'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
integrationIdinteger  (int64)    <style>.public-api-info {    background: rgb(222, 235, 255);}.public-api-tip {    background: rgb(227, 252, 239);}.public-api-parameter {    background: rgba(9,30,66,0.08);}.public-api-note {    background: rgb(234, 230, 255);}.public-api-important {    background: rgb(255, 250, 230);}.public-api-critical {    background: rgb(255, 235, 230);}table, th, td {  border: 1px solid gray;  border-collapse: collapse;}th, td {  padding: 5px;}th {  text-align: left;}img {  border: 2px solid #D3D5D9;}</style>Your integration ID to be used in requests to the API. This ensures you are accessing the correct integration.  
**Note:** Parse the integrationId as Long or BigInt. Parsing the integrationId as an Integer will truncate the integrationId to trailing zeros and will return an incorrect ID.
Example5517027188234206000

400

Malformed request

<select class='api-response-data' aria-label='Media type'><option value='d40770a9-77a7-4866-becc-9d0915db13d6'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

401

Access denied

<select class='api-response-data' aria-label='Media type'><option value='0e9589ba-01c4-445b-a8d2-26a232ffca91'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

409

Conflict - Event was already reported in the past.

<select class='api-response-data' aria-label='Media type'><option value='c3abe4a7-2f72-4397-860d-61d9c20a85eb'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

429

API request limit exceeded

HeadersRetry-AfterintegerNumber of seconds to wait before making a new request.
<select class='api-response-data' aria-label='Media type'><option value='8604ff6e-e961-4d52-874b-15e48565678a'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string    

500

Failed to complete the operation due to an unexpected error

<select class='api-response-data' aria-label='Media type'><option value='fe86d88d-3836-4835-93a1-78e32318bc67'>application/json</option>
</select>object  requestIdstring    

A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.

Example4al018gzaztcr8nbukw
errors Array of string   

Error messages.

Example[
  "An error has occurred"
]string