MATTR VII PlatformParticipant contacts
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}/contactsAuthorization
bearerAuth AuthorizationBearer <token>
In: header
Path Parameters
participantId*string
The UUID of the participant
Format
uuidecosystemId*string
The UUID of the ecosystem
Format
uuidRequest 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.
Format
emailprimaryPhoneNumber?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?