Create a participant point of contact

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

Roles

admindts-provider

POST/v1/ecosystems/{ecosystemId}/participants/{participantId}/contacts

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

Request Body

fullNamestring

Full name of the point of contact.

activeboolean

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

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
  }'

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"
    }
  ]
}