Create a Location

Changed on

Creates a new Location object. For further details, including which address fields are required in each country, see the Manage locations guide.

post/v1/terminal/locations

Request

  • Base URL: https://api.stripe.com
  • URL: https://api.stripe.com/v1/terminal/locations
  • Auth: one of:
    • HTTP basic
    • HTTP bearer

Request body application/x-www-form-urlencoded

configuration_overridesstring

The ID of a configuration that will be used to customize all readers in this location.

display_namestring

A name for the location. Maximum length is 1000 characters.

display_name_kanastring

The Kana variation of the name for the location (Japan only). Maximum length is 1000 characters.

display_name_kanjistring

The Kanji variation of the name for the location (Japan only). Maximum length is 1000 characters.

expandstring[]

Specifies which fields in the response should be expanded.

phonestring

The phone number for the location.

Response

Successful response.

configuration_overridesstring

The ID of a configuration that will be used to customize all readers in this location.

display_namestring required

The display name of the location.

display_name_kanastring

The Kana variation of the display name of the location.

display_name_kanjistring

The Kanji variation of the display name of the location.

idstring required

Unique identifier for the object.

livemodeboolean required

If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

metadataobject required

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

object'terminal.location' required

String representing the object's type. Objects of the same type share the same value.

phonestring

The phone number of the location.

Changes

  • c113b1939b8fRevision changes
    • info

      added the optional property ////// to the response with the status

  • 7b8f614372caRevision changes
    • info

      added the optional property ////////// to the response with the status

Some revisions have not been checked yet.