Configure custom domain

Creates a custom domain configuration on your tenant. You can configure a custom domain for a specific MATTR VII tenant to represent your brand and instil trust with your end-users. Any MATTR VII tenant can only have one custom domain. Refer to our docs for more information.

Analytics Events

CONFIG_CUSTOM_DOMAIN_CREATE_STARTCONFIG_CUSTOM_DOMAIN_CREATE_SUCCESSCONFIG_CUSTOM_DOMAIN_CREATE_FAIL

Roles

adminissuerverifierdts-provider

POST/v1/config/domain

Authorization

AuthorizationBearer <token>

In: header

Request Body

The custom domain payload

namestring

Insert a name for the custom domain that will be displayed to digital wallet holders when they receive credential offers or verification requests from this tenant.

logoUrlstring

Insert a URL for a square logo that will be displayed to digital wallet holders when they receive credential offers or verification requests from your MATTR VII tenant:

URL must be publicly available.
Must be a square image, recommended 64x64 px in size
png and jpg files are supported.
The recommended maximum size is 15 KB.

domainstring

Insert the full custom domain, leaving out the protocol (e.g. https://).

Response Body

curl -X POST "https://example.vii.au01.mattr.global/v1/config/domain" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Example Corp",
    "logoUrl": "https://cdn.example.com/logo.jpg",
    "domain": "example.com"
  }'

curl -X POST "https://example.vii.au01.mattr.global/v1/config/domain" \  -H "Content-Type: application/json" \  -d '{    "name": "Example Corp",    "logoUrl": "https://cdn.example.com/logo.jpg",    "domain": "example.com"  }'

{
  "name": "Example Corp",
  "logoUrl": "https://cdn.example.com/logo.jpg",
  "domain": "example.com",
  "verificationToken": "8c6f36c1-91ff-439d-a518-48cf7ef421ef",
  "isVerified": false
}

{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}