Domain Contacts2026.8.0

Create domain contact

Adds a new contact to the specified domain.

POST/api/v1/spaces/assets/domains/{domain}/contacts

The source export uses a local development server. Examples use the configured Dashio API origin.

The export references authentication schemes without supplying their definitions.

Authentication

bearerAuth

Understand authentication

Path parameters

domainstringRequired: Domain name in FQDN format

Query parameters

None declared in this export.

Header parameters

None declared in this export.

Request body

application/json · Required

spaceIdstring (uuid) | nullOptional

No field description supplied.

contactobjectRequired

No field description supplied.

typestringRequired

Allowed values: "PERSON", "ORG".

rolestringRequired

Allowed values: "owner", "admin", "tech", "billing".

firstNamestringRequired

No field description supplied.

lastNamestringRequired

No field description supplied.

genderstringRequired

Allowed values: "M", "F", "U".

emailstring (email)Required

No field description supplied.

phoneobjectRequired

No field description supplied.

addressobjectRequired

No field description supplied.

Request & response examples

Copy an example in your preferred language.

request.sh

curl --request POST 'https://dashio.net/api/v1/spaces/assets/domains/{domain}/contacts' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{
  "contact": {
    "type": "PERSON",
    "role": "owner",
    "firstName": "<firstName>",
    "lastName": "<lastName>",
    "gender": "M",
    "email": "<email>",
    "phone": {
      "countryCode": "<countryCode>",
      "areaCode": "<areaCode>",
      "subscriberNumber": "<subscriberNumber>"
    },
    "address": {
      "street": [
        "<street>"
      ],
      "city": "<city>",
      "zip": "<zip>",
      "country": "<country>"
    }
  }
}'

Replace URL parameters, credentials, and schema placeholders before running. No request is sent by this page.

Schema-generated example; not a captured response.

{
  "contact": {
    "id": 0,
    "type": "PERSON",
    "role": "owner",
    "firstName": "<firstName>",
    "lastName": "<lastName>",
    "gender": "M",
    "email": "<email>",
    "phone": {
      "countryCode": "<countryCode>",
      "areaCode": "<areaCode>",
      "subscriberNumber": "<subscriberNumber>"
    },
    "address": {
      "street": [
        "<street>"
      ],
      "city": "<city>",
      "zip": "<zip>",
      "country": "<country>"
    }
  }
}

Examples use the configured API origin. Replace credentials, URL parameters, and schema placeholders before running.

Responses

200

Contact created successfully.

contactobjectRequired

No field description supplied.

idnumberRequired

No field description supplied.

typestringRequired

Allowed values: "PERSON", "ORG".

rolestringRequired

Allowed values: "owner", "admin", "tech", "billing".

firstNamestringRequired

No field description supplied.

lastNamestringRequired

No field description supplied.

genderstringRequired

Allowed values: "M", "F", "U".

emailstring (email)Required

No field description supplied.

phoneobjectRequired

No field description supplied.

addressobjectRequired

No field description supplied.

400

Invalid request.

No response body schema supplied.

404

Domain not found.

No response body schema supplied.

500

Failed to create contact.

No response body schema supplied.

Was this helpful?

Create domain contact

Authentication

Path parameters

Query parameters

Header parameters

Cookie parameters

Request body

8 child fields

Responses

200

9 child fields

400

404

500