Skip to main content
Creating a destination also creates Version 1 of its API. The dialog therefore mixes properties of the destination itself (name, description, type) with properties of that first version (authentication, languages, regions).
1

Open the dialog

On the destinations listing, click New destination.
2

Choose a destination type

The destination type optionsThe type is fixed at creation and cannot be changed afterwards — it decides how data is served and how many client applications the destination will accept. See Destination types.
3

Name it

The new destination dialog
  • Display name — what you and your colleagues see in Studio.
  • Safe name — the URL segment. Studio derives it from the display name as you type, converting it to camelCase and dropping anything that is not alphanumeric, but you can overwrite it.
  • Description — optional.
The safe name becomes part of every URL this destination serves — https://global.occtoo.com/{environment}/{safe name}/v{version}. It cannot be changed once the destination exists, so a rename later means a new destination and new URLs for every consumer.
4

Choose the authentication

Protected requires a token from a registered application; Public serves anyone with the URL.
This choice only appears for the Multi-consumer type. Every other type is Protected.
5

Add the languages

Each row maps a Source language — a language key that already exists in your onboarded data — to the Destination language code you want to expose on the API. Use Add language for another row, and pick which of them is the Default language.Languages and regions in the new destination dialogKeys and values are 2–10 characters, may contain only letters, digits, _ and -, and must each be unique within the destination. Add every language you intend to query on — localized fields cannot be requested for a language the destination does not carry. See Languages.
6

Choose the regions

Regions are where the API is hosted, and Default region is the one used when a caller does not specify. Only the regions your contract covers are listed; if there is a single option it is chosen for you.
7

Save

Click Save. Studio opens the new destination on Version 1, in the Not published state.
The destination has no endpoints yet, and cannot be published until it has at least one — continue with Create an endpoint.