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

# Create a destination

> Creates a new destination.

**Required ACL:** `addObject`, `deleteIndex`, `editSettings`

## Usage

<CodeGroup>
  ```cs C# theme={"system"}
  // Initialize the client
  var client = new IngestionClient(
    new IngestionConfig("ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY", "ALGOLIA_APPLICATION_REGION")
  );

  // Call the API
  var response = await client.CreateDestinationAsync(
    new DestinationCreate
    {
      Type = Enum.Parse<DestinationType>("Search"),
      Name = "destinationName",
      Input = new DestinationInput { IndexName = "<YOUR_INDEX_NAME>" },
      AuthenticationID = "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
    }
  );

  // print the response
  Console.WriteLine(response);
  ```

  ```dart Dart theme={"system"}
  // Initialize the client
  final client = IngestionClient(
      appId: 'ALGOLIA_APPLICATION_ID',
      apiKey: 'ALGOLIA_API_KEY',
      region: 'ALGOLIA_APPLICATION_REGION');

  // Call the API
  final response = await client.createDestination(
    destinationCreate: DestinationCreate(
      type: DestinationType.fromJson("search"),
      name: "destinationName",
      input: DestinationInput(
        indexName: "<YOUR_INDEX_NAME>",
      ),
      authenticationID: "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
    ),
  );

  // print the response
  print(response);
  ```

  ```go Go theme={"system"}
  // Initialize the client with your application region, eg. ingestion.ALGOLIA_APPLICATION_REGION
  client, err := ingestion.NewClient("ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY", ingestion.US)
  if err != nil {
    // The client can fail to initialize if you pass an invalid parameter.
    panic(err)
  }

  // Call the API
  response, err := client.CreateDestination(client.NewApiCreateDestinationRequest(

    ingestion.NewEmptyDestinationCreate().SetType(ingestion.DestinationType("search")).SetName("destinationName").SetInput(
      ingestion.NewEmptyDestinationInput().SetIndexName("<YOUR_INDEX_NAME>")).SetAuthenticationID("6c02aeb1-775e-418e-870b-1faccd4b2c0f")))
  if err != nil {
    // handle the eventual error
    panic(err)
  }


  // print the response
  print(response)
  ```

  ```java Java theme={"system"}
  // Initialize the client
  IngestionClient client = new IngestionClient("ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY", "ALGOLIA_APPLICATION_REGION");

  // Call the API
  DestinationCreateResponse response = client.createDestination(
    new DestinationCreate()
      .setType(DestinationType.SEARCH)
      .setName("destinationName")
      .setInput(new DestinationInput().setIndexName("<YOUR_INDEX_NAME>"))
      .setAuthenticationID("6c02aeb1-775e-418e-870b-1faccd4b2c0f")
  );

  // print the response
  System.out.println(response);
  ```

  ```js JavaScript theme={"system"}
  // Initialize the client
  // Replace 'us' with your Algolia Application Region
  const client = algoliasearch('ALGOLIA_APPLICATION_ID', 'ALGOLIA_API_KEY').initIngestion({ region: 'us' });

  // Call the API
  const response = await client.createDestination({
    type: 'search',
    name: 'destinationName',
    input: { indexName: 'full_name______' },
    authenticationID: '6c02aeb1-775e-418e-870b-1faccd4b2c0f',
  });


  // print the response
  console.log(response);
  ```

  ```kotlin Kotlin theme={"system"}
  // Initialize the client
  val client =
    IngestionClient(
      appId = "ALGOLIA_APPLICATION_ID",
      apiKey = "ALGOLIA_API_KEY",
      region = "ALGOLIA_APPLICATION_REGION",
    )

  // Call the API
  var response =
    client.createDestination(
      destinationCreate =
        DestinationCreate(
          type = DestinationType.entries.first { it.value == "search" },
          name = "destinationName",
          input = DestinationInput(indexName = "<YOUR_INDEX_NAME>"),
          authenticationID = "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
        )
    )


  // print the response
  println(response)
  ```

  ```php PHP theme={"system"}
  // Initialize the client
  $client = IngestionClient::create('ALGOLIA_APPLICATION_ID', 'ALGOLIA_API_KEY', 'ALGOLIA_APPLICATION_REGION');

  // Call the API
  $response = $client->createDestination(
      ['type' => 'search',
          'name' => 'destinationName',
          'input' => ['indexName' => '<YOUR_INDEX_NAME>',
          ],
          'authenticationID' => '6c02aeb1-775e-418e-870b-1faccd4b2c0f',
      ],
  );


  // print the response
  var_dump($response);
  ```

  ```python Python theme={"system"}
  # Initialize the client
  # In an asynchronous context, you can use IngestionClient instead, which exposes the exact same methods.
  client = IngestionClientSync(
      "ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY", "ALGOLIA_APPLICATION_REGION"
  )

  # Call the API
  response = client.create_destination(
      destination_create={
          "type": "search",
          "name": "destinationName",
          "input": {
              "indexName": "<YOUR_INDEX_NAME>",
          },
          "authenticationID": "6c02aeb1-775e-418e-870b-1faccd4b2c0f",
      },
  )


  # print the response
  print(response)
  ```

  ```ruby Ruby theme={"system"}
  # Initialize the client
  client = Algolia::IngestionClient.create("ALGOLIA_APPLICATION_ID", "ALGOLIA_API_KEY", "ALGOLIA_APPLICATION_REGION")

  # Call the API
  response = client.create_destination(
    Algolia::Ingestion::DestinationCreate.new(
      type: "search",
      name: "destinationName",
      input: Algolia::Ingestion::DestinationInput.new(index_name: "<YOUR_INDEX_NAME>"),
      authentication_id: "6c02aeb1-775e-418e-870b-1faccd4b2c0f"
    )
  )


  # print the response
  puts(response)
  ```

  ```scala Scala theme={"system"}
  // Initialize the client
  val client = IngestionClient(
    appId = "ALGOLIA_APPLICATION_ID",
    apiKey = "ALGOLIA_API_KEY",
    region = "ALGOLIA_APPLICATION_REGION"
  )

  // Call the API
  val response = Await.result(
    client.createDestination(
      destinationCreate = DestinationCreate(
        `type` = DestinationType.withName("search"),
        name = "destinationName",
        input = DestinationInput(
          indexName = "<YOUR_INDEX_NAME>"
        ),
        authenticationID = Some("6c02aeb1-775e-418e-870b-1faccd4b2c0f")
      )
    ),
    Duration(100, "sec")
  )

  // print the response
  println(response)
  ```

  ```swift Swift theme={"system"}
  // Initialize the client
  let client = try IngestionClient(appID: "ALGOLIA_APPLICATION_ID", apiKey: "ALGOLIA_API_KEY", region: .us)

  // Call the API
  let response = try await client.createDestination(destinationCreate: DestinationCreate(
      type: DestinationType.search,
      name: "destinationName",
      input: DestinationInput(indexName: "<YOUR_INDEX_NAME>"),
      authenticationID: "6c02aeb1-775e-418e-870b-1faccd4b2c0f"
  ))

  // print the response
  print(response)
  ```
</CodeGroup>

<Card icon="folder-code" horizontal="true" title="See the full API reference" arrow="true" href="/doc/rest-api/ingestion/create-destination">
  For more details about input parameters
  and response fields.
</Card>
