> ## Documentation Index > Fetch the complete documentation index at: https://nango.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # API configuration (`providers.yaml`) API configurations are listed in the `providers.yaml` file, located in the [Nango GitHub repository](https://github.com/NangoHQ/nango/blob/master/packages/providers/providers.yaml). # Examples ```yaml theme={null} hubspot: display_name: HubSpot categories: - marketing - support - crm auth_mode: OAUTH2 authorization_url: https://app.hubspot.com/oauth/authorize token_url: https://api.hubapi.com/oauth/v1/token connection_configuration: - portalId post_connection_script: hubspotPostConnection webhook_routing_script: hubspotWebhookRouting proxy: base_url: https://api.hubapi.com decompress: true paginate: type: cursor cursor_path_in_response: paging.next.after limit_name_in_request: limit cursor_name_in_request: after response_path: results docs: https://nango.dev/docs/api-integrations/hubspot ``` ```yaml theme={null} salesforce: display_name: Salesforce categories: - crm auth_mode: OAUTH2 authorization_url: https://login.salesforce.com/services/oauth2/authorize token_url: https://login.salesforce.com/services/oauth2/token authorization_params: prompt: consent default_scopes: - offline_access token_response_metadata: - instance_url proxy: base_url: ${connectionConfig.instance_url} webhook_routing_script: salesforceWebhookRouting post_connection_script: salesforcePostConnection docs: https://nango.dev/docs/api-integrations/salesforce connection_config: instance_url: type: string title: Instance URL description: The instance URL of your Salesforce account format: uri pattern: '^https?://.*$' ``` ```yaml theme={null} google: display_name: Google auth_mode: OAUTH2 authorization_url: https://accounts.google.com/o/oauth2/v2/auth token_url: https://oauth2.googleapis.com/token authorization_params: response_type: code access_type: offline prompt: consent proxy: base_url: https://www.googleapis.com paginate: type: cursor cursor_path_in_response: nextPageToken limit_name_in_request: maxSize cursor_name_in_request: pageToken response_path: items docs: https://nango.dev/docs/api-integrations/google ``` ```yaml theme={null} notion: display_name: Notion categories: - knowledge-base - productivity auth_mode: OAUTH2 authorization_url: https://api.notion.com/v1/oauth/authorize token_url: https://api.notion.com/v1/oauth/token authorization_params: response_type: code owner: user authorization_method: header body_format: json proxy: retry: after: 'Retry-After' base_url: https://api.notion.com headers: 'Notion-Version': '2022-06-28' paginate: type: cursor cursor_path_in_response: next_cursor cursor_name_in_request: start_cursor limit_name_in_request: page_size response_path: results docs: https://nango.dev/docs/api-integrations/notion ``` ```yaml theme={null} linear: display_name: Linear categories: - productivity - ticketing auth_mode: OAUTH2 authorization_url: https://linear.app/oauth/authorize token_url: https://api.linear.app/oauth/token scope_separator: ',' authorization_params: prompt: consent proxy: base_url: https://api.linear.app disable_pkce: true webhook_routing_script: linearWebhookRouting post_connection_script: linearPostConnection webhook_user_defined_secret: true docs: https://nango.dev/docs/api-integrations/linear ``` ```yaml theme={null} slack: display_name: Slack categories: - productivity auth_mode: OAUTH2 authorization_url: https://slack.com/oauth/v2/authorize token_url: https://slack.com/api/oauth.v2.access token_response_metadata: - incoming_webhook.url - incoming_webhook.channel - incoming_webhook.channel_id - bot_user_id - team.id proxy: base_url: https://slack.com/api paginate: type: cursor cursor_path_in_response: response_metadata.next_cursor cursor_name_in_request: cursor limit_name_in_request: limit webhook_routing_script: slackWebhookRouting docs: https://nango.dev/docs/api-integrations/slack ``` # All configuration fields Looking for the JSON Schema, find it in our [GitHub](https://github.com/NangoHQ/nango/blob/master/scripts/validation/providers/schema.json) Allows to extend the configuration of another API. The display name of the provider, used in the UI. The authentication mode. Must be one of: "API\_KEY", "APP", "APP\_STORE", "BASIC", "NONE", "OAUTH1", "OAUTH2", "OAUTH2\_CC", "CUSTOM", "TBA", "JWT", "BILL", "TWO\_STEP", "SIGNATURE". Authentication configuration. The response type for authentication. The authorization method. Must be `header` Query parameters of the authorization request. Possible value: "offline" Possible values: "auto", "force" Possible value: "permanent" Possible value: "never" Whether to force verification A unique string to be included in the request Possible value: "consent" The mode of the response The type of the response The URL to get the OAuth 2 credentials from the external API. Should the `authorization_url` be encoded or not An object containing key-value pairs for replacements in the authorization URL. The format of the request body. e.g: `json` An array of strings representing the categories of the API. An array of strings representing the `connectionConfig` that are automatically populated by post-connection functions. Whether to decode the URL or not. The minimum list of scopes that are necessary to connect to the API. Disables the [PKCE](https://oauth.net/2/pkce/) extension to the Authorization Code flow. The URL to the developer API documentation. The URL to the end user documentation (e.g: how to connect). The name of the script to run after a connection is established. Proxy configuration for the API. The base URL for the API. Whether to decompress the response. Headers to be sent with each request. Pagination configuration. The name of the cursor parameter in the request. The path to the cursor value in the response. The name of the limit parameter in the request. The rel attribute of the link header for pagination. The path to the link in the response body. The name of the offset parameter in the request. The method to calculate the offset in the request. Must be one of: "per-page" or "by-response-size". Optional parameter that defaults to "by-response-size". The starting value for the offset. The path to the paginated data in the response. The type of pagination. Must be one of: "link", "cursor", "offset". Query parameters to be sent with each request. Retry configuration. The name of the rate-limit header, e.g. `after: 'X-Rate-Limit-Reset'` The name of the rate-limit header, e.g. `at: 'x-ratelimit-reset'` Configure a HTTP call to verify if credentials are valid, only used for API Key and Basic auth. The HTTP method for verification. Must be either "GET" or "POST". The endpoint for verification. Override the base URL for verification. Headers for the verification request. The metadata to capture from the callback request. The URL used for refreshing the access token. Defaults to the `token_url` Parameters used for refreshing the access token. The grant type for refreshing the token. Must be "refresh\_token". An object containing request parameters to pass to an authorization request. The URL for making API an authorization request. The separator used between scopes in the authorization request. Defaults to space, but some APIs sur `,` or `+`. The signature method used for OAuth 1.0. Must be either "HMAC-SHA1" or "PLAINTEXT". A buffer time (in seconds) before the token expiration to trigger a refresh. Parameters used for obtaining the access token. The grant type for obtaining the token. Must be either "authorization\_code" or "client\_credentials". Additional request information for obtaining the token. The authentication method used for token requests. Must be either "basic" or "custom". The unit of time for token expiration. Must be "milliseconds". An array of strings representing metadata from the token response that will be saved in `connection.metadata`. The URL to get the OAuth 2 credentials from the external API. Should the `token_url` be encoded or not Wether the webhook secret is set by the user. Specifies a script to handle external [webhooks](/getting-started/use-cases/webhooks-from-external-apis). Specifies a fragment to be appended to the authorization URL, typically used to modify the redirection flow or pass additional information in the URL before the query parameters. The list of properties available in `${connectionConfig}` and their validation. The type of this value. Must be "string". The title of this value. The description of this value. An example of valid value to display in a UI. A regex pattern for the credential. The special format of this value (e.g: `hostname`, `uri`) The order in which this field should be displayed in a UI The documentation section relative to `docs_connect` The list of credentials and their validation, only filed if necessary (e.g: API\_KEY, BASIC) The type of the credential. Must be "string". The title of the credential. The description of the credential. An example of the credential. A pattern for the credential. The format of the credential. The documentation section for the credential. **Questions, problems, feedback?** Please reach out in the [Slack community](https://nango.dev/slack).