--- title: Get all connected Salesforce organizations description: Get all Salesforce organizations connected to your Datadog organization through the Salesforce integration. breadcrumbs: Docs > API > Get all connected Salesforce organizations --- > For the complete documentation index, see [llms.txt](https://dnd37xeb23o8n.cloudfront.net/stefon.simmons/docs-astro-web-10435/llms.txt). # Get all connected Salesforce organizations ## v2 (deprecated) | Datadog site | API endpoint | | ----------------- | --------------------------------------------------------------------------------------- | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/integration/salesforce-incidents/organizations | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/integration/salesforce-incidents/organizations | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/integration/salesforce-incidents/organizations | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/integration/salesforce-incidents/organizations | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/integration/salesforce-incidents/organizations | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/integration/salesforce-incidents/organizations | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/integration/salesforce-incidents/organizations | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/integration/salesforce-incidents/organizations | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/integration/salesforce-incidents/organizations | ### Overview Get all Salesforce organizations connected to your Datadog organization through the Salesforce integration. Salesforce organizations are connected through the OAuth setup flow in the Datadog Salesforce integration page. This endpoint requires the `integrations_read` permission. ### Response {% tabs %} {% tab label="200" %} OK {% tabs %} {% tab label="Model" %} Response containing a list of Salesforce organizations connected to the Datadog Salesforce integration. | Parent field | Field | Type | Description | | ------------ | ----------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- | | | data [*required*] | [object] | An array of Salesforce organizations. | | data | attributes [*required*] | object | Attributes of a Salesforce organization connected to the Datadog Salesforce integration. | | attributes | instance_url | string | The Salesforce instance URL used to call this organization's APIs. | | attributes | name | string | Human-readable name of the Salesforce organization. | | attributes | sfdc_org_id | string | The Salesforce organization identifier (15- or 18-character Salesforce org ID). | | attributes | sfdc_org_type | string | The Salesforce organization type (for example, `Production` or `Sandbox`). | | data | id [*required*] | string | The Datadog-assigned ID of the connected Salesforce organization. | | data | type [*required*] | enum | Salesforce organization resource type. Allowed enum values: `salesforce-incidents-org`. Default: `salesforce-incidents-org`. | {% /tab %} {% tab label="Example" %} ```json { "data": [ { "attributes": { "instance_url": "https://acme.my.salesforce.com", "name": "Acme Production Org", "sfdc_org_id": "00D000000000000", "sfdc_org_type": "Production" }, "id": "596da4af-0563-4097-90ff-07230c3f9db3", "type": "salesforce-incidents-org" } ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="400" %} Bad Request {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="403" %} Forbidden {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="404" %} Not Found {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% tab label="429" %} Too many requests {% tabs %} {% tab label="Model" %} API error response. | Field | Type | Description | | ------------------- | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab label="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tabs %} {% /tab %} {% /tabs %} ### Code Example {% tabs %} {% tab label="Curl" %} ```bash # Set your Datadog site and credentials export DD_SITE="datadoghq.com" # Or us3.datadoghq.com, us5.datadoghq.com, datadoghq.eu, ap1.datadoghq.com, ap2.datadoghq.com, uk1.datadoghq.com, ddog-gov.com, us2.ddog-gov.com # Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="" curl -X GET "https://api.${DD_SITE}/api/v2/integration/salesforce-incidents/organizations" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" ``` {% /tab %} {% tab label="Go" %} ```go // Get all connected Salesforce organizations returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { ctx := datadog.NewDefaultContext(context.Background()) ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN")) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewSalesforceIntegrationApi(apiClient) resp, r, err := api.GetSalesforceOrganizations(ctx) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `SalesforceIntegrationApi.GetSalesforceOrganizations`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `SalesforceIntegrationApi.GetSalesforceOrganizations`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" go run "main.go" ``` {% /tab %} {% tab label="Java" %} ```java // Get all connected Salesforce organizations returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.SalesforceIntegrationApi; import com.datadog.api.client.v2.model.SalesforceIncidentsOrganizationsResponse; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN")); SalesforceIntegrationApi apiInstance = new SalesforceIntegrationApi(defaultClient); try { SalesforceIncidentsOrganizationsResponse result = apiInstance.getSalesforceOrganizations(); System.out.println(result); } catch (ApiException e) { System.err.println( "Exception when calling SalesforceIntegrationApi#getSalesforceOrganizations"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" java "Example.java" ``` {% /tab %} {% tab label="Python" %} ```python """ Get all connected Salesforce organizations returns "OK" response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.salesforce_integration_api import SalesforceIntegrationApi configuration = Configuration() configuration.access_token = environ["DD_BEARER_TOKEN"] with ApiClient(configuration) as api_client: api_instance = SalesforceIntegrationApi(api_client) response = api_instance.get_salesforce_organizations() print(response) ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" python3 "example.py" ``` {% /tab %} {% tab label="Ruby" %} ```ruby # Get all connected Salesforce organizations returns "OK" response require "datadog_api_client" DatadogAPIClient.configure do |config| config.access_token = ENV["DD_BEARER_TOKEN"] end api_instance = DatadogAPIClient::V2::SalesforceIntegrationAPI.new p api_instance.get_salesforce_organizations() ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" rb "example.rb" ``` {% /tab %} {% tab label="Rust" %} ```rust // Get all connected Salesforce organizations returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_salesforce_integration::SalesforceIntegrationAPI; #[tokio::main] async fn main() { let configuration = datadog::Configuration::new(); let api = SalesforceIntegrationAPI::with_config(configuration); let resp = api.get_salesforce_organizations().await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: ```bash DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ``` {% /tab %} {% tab label="TypeScript" %} ```typescript /** * Get all connected Salesforce organizations returns "OK" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration({ authMethods: { AuthZ: { accessToken: process.env.DD_BEARER_TOKEN as string, }, }, }); const apiInstance = new v2.SalesforceIntegrationApi(configuration); apiInstance .getSalesforceOrganizations() .then((data: v2.SalesforceIncidentsOrganizationsResponse) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://dnd37xeb23o8n.cloudfront.net/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: ```bash DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" tsc "example.ts" ``` {% /tab %} {% /tabs %}