light-mode-image
Learn
API ReferenceParticipant contacts

Create a participant point of contact

Roles

admindts-provider
POST/v1/ecosystems/{ecosystemId}/participants/{participantId}/contacts

Create a new point of contact for the specified participant. A maximum of 10 contacts can exist per participant.

Analytic events

  • ECOSYSTEM_PARTICIPANT_CONTACT_CREATE_START
  • ECOSYSTEM_PARTICIPANT_CONTACT_CREATE_SUCCESS
  • ECOSYSTEM_PARTICIPANT_CONTACT_CREATE_FAIL

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

participantId*string

The UUID of the participant

Formatuuid
ecosystemId*string

The UUID of the ecosystem

Formatuuid

Request Body

application/json

fullName*string

Full name of the point of contact.

active*boolean

Indicates whether the point of contact is active.

emailAddress?string

Email address of the point of contact.

Formatemail
primaryPhoneNumber?string

Primary phone number of the point of contact.

secondaryPhoneNumber?string

Secondary phone number of the point of contact.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.vii.au01.mattr.global/v1/ecosystems/87880d7e-a4d0-462e-8383-3f1e5e16865d/participants/a24e391a-c27f-4b6e-9805-1ee7e03f3c58/contacts" \  -H "Content-Type: application/json" \  -d '{    "fullName": "John Doe",    "active": true  }'
{
  "id": "920f2489-d953-42f2-b2dd-f37c29b818cf",
  "fullName": "John Doe",
  "active": true,
  "emailAddress": "john.doe@example.com",
  "primaryPhoneNumber": 1234567890,
  "secondaryPhoneNumber": 987654321,
  "createdBy": {
    "clientId": "f7b9ecfc-8431-470e-a1de-94b68dd92f68",
    "managementUserId": "ab16dc65-b58e-4be2-ba77-a6f35021cb2b"
  },
  "createdAt": "2025-07-01T00:00:00.000Z",
  "lastModifiedBy": {
    "clientId": "f7b9ecfc-8431-470e-a1de-94b68dd92f68",
    "managementUserId": "ab16dc65-b58e-4be2-ba77-a6f35021cb2b"
  },
  "lastModifiedAt": "2025-07-01T00:00:00.000Z"
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}
{
  "code": "string",
  "message": "string",
  "details": [
    {
      "value": "string",
      "msg": "Invalid value",
      "param": "id",
      "location": "body"
    }
  ]
}

How would you rate this page?

Delete verifier assignment DELETE

Removes a credential type from the requested participant in the requested ecosystem.. ### **Analytic events** * ECOSYSTEM_VERIFIER_POLICY_DELETE_START * ECOSYSTEM_VERIFIER_POLICY_DELETE_SUCCESS * ECOSYSTEM_VERIFIER_POLICY_DELETE_FAIL

Retrieve all participant points of contact GET

Retrieve all points of contact for given participant. ### **Analytic events** * ECOSYSTEM_PARTICIPANT_CONTACT_RETRIEVE_LIST_START * ECOSYSTEM_PARTICIPANT_CONTACT_RETRIEVE_LIST_SUCCESS * ECOSYSTEM_PARTICIPANT_CONTACT_RETRIEVE_LIST_FAIL