Create a new location

Production

https://api-v2.getmarvia.com

POST

/v1/locations

Required Permission: create:locations

This endpoint requires an API key with the create:locations permission. Make sure your token was created with this permission during token creation.

Request

Authorization

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

API Key

Add parameter in header

Authorization

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠409Conflict

🔴500Internal Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api-v2.getmarvia.com/v1/locations' \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "identifier": "string",
    "address": {
        "addressLine1": "string",
        "addressLine2": "string",
        "attentionOf": "string",
        "city": "string",
        "zone": "string",
        "countryCode": "string",
        "zipcode": "string"
    },
    "legal": {
        "address": {
            "addressLine1": "string",
            "addressLine2": "string",
            "attentionOf": "string",
            "city": "string",
            "zone": "string",
            "countryCode": "string",
            "zipcode": "string"
        }
    },
    "invoice": {
        "name": "string",
        "email": "string",
        "address": {
            "addressLine1": "string",
            "addressLine2": "string",
            "attentionOf": "string",
            "city": "string",
            "zone": "string",
            "countryCode": "string",
            "zipcode": "string"
        }
    },
    "contact": {
        "email": "string",
        "website": "string",
        "phone": "string",
        "mobile": "string",
        "firstName": "string"
    },
    "coordinates": {
        "latitude": 0,
        "longitude": 0
    }
}'

Response Example

201 - Example 1

{
    "_tag": "Success",
    "data": {
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f"
    }
}

Modified at 2025-12-01 12:41:52

List locations

Get a group