Trustmary Integration API (1.0.0)

Download OpenAPI specification:Download

API key test

Authorizations:

ApiKeyAuth

Responses

Response samples

200
403
500

Content type

application/json

{"message": "Your API key is working",
"organization_id": "testorg",
"organization_name": "Test Organization",
"api_key_name": "Test API key"
}

List contacts

Authorizations:

ApiKeyAuth

query Parameters

email	string Email to filter by
offset	integer <int32> Start offset for query
includeAll	boolean Include also contacts marked as deleted.

Responses

Response samples

200
400
403
500

Content type

application/json

[{"id": "Ujdno_k8k",
"email": "[email protected]",
"name": "Frank Mushroom",
"firstname": "Frank",
"lastname": "Mushroom",
"eid": "Thow9nJ23",
"phone": "+358100100",
"company": "Company Inc",
"created_at": "2021-09-29T14:14:46.651Z",
"updated_at": "2021-09-29T14:14:46.651Z",
"last_action": "2021-09-29T14:14:46.762Z",
"deleted_at": null,
"status": "active",
"type": "customer",
"nps_status": "promoter",
"original_nps_status": "passive",
"recommend_status": "recommend",
"nps_change": "up"
}
]

Create or update contact

Authorizations:

ApiKeyAuth

Request Body schema: application/json
required

Contact data

email required	string
name	string
eid	string
phone	string
company	string
type	string Enum: "customer" "employee"
addToList	Array of strings

Responses

Request samples

Payload

Content type

application/json

{"email": "string",
"name": "string",
"eid": "string",
"phone": "string",
"company": "string",
"type": "customer",
"addToList": ["string"
]
}

Response samples

200
400
403
500

Content type

application/json

{"contact": {"id": "85jtL8fjw",
"email": "[email protected]",
"created_at": "2021-09-29T14:14:46.651Z",
"updated_at": "2021-09-29T14:14:46.651Z",
"status": "active",
"type": "customer",
"name": "Frank Mushroom",
"phone": "+358100100",
"eid": "jJkirjK9",
"company": "Company Inc"
},
"action": "IMPORT_CREATE",
"listsUpdated": 1
}

Delete contact

Authorizations:

ApiKeyAuth

Request Body schema: application/json
required

email

string

Responses

Request samples

Payload

Content type

application/json

{"email": "string"
}

Response samples

200
400
403
500

Content type

application/json

{"contact": {"email": "[email protected]",
"id": "qaPTkgycqd",
"created_at": "2021-09-30T09:19:28.385Z",
"updated_at": "2021-09-30T09:19:28.385Z",
"deleted_at": "2021-10-11T10:35:01.567Z",
"last_action": "2021-09-30T09:19:34.691Z",
"status": "active",
"type": "customer",
"name": "Sarah Oak",
"lastname": "Oak",
"firstname": "Sarah"
}
}

List contact lists

Authorizations:

ApiKeyAuth

Responses

Response samples

200
400
403
500

Content type

application/json

[{"id": "W0yDxNPeK",
"type": "employee",
"count": 5,
"name": "Customer list",
"source": "list",
"created_at": "2021-09-29T14:13:53.784Z",
"updated_at": "2021-09-29T14:13:53.784Z",
"deleted_at": null
}
]

List surveys

Authorizations:

ApiKeyAuth

query Parameters

type	string Enum: "customer" "employee" Survey type to filter by
offset	integer <int32> Start offset for query

Responses

Response samples

200
400
403
500

Content type

application/json

[{"id": "5iEwG88ib",
"type": "customer",
"count": 2,
"name": "NPS survey",
"created_at": "2021-09-29T14:06:13.963Z",
"updated_at": "2021-09-29T14:06:13.963Z",
"deleted_at": null
},
{"id": "c8U5ckfks",
"type": "customer",
"count": 15,
"name": "Video review",
"created_at": "2021-03-23T13:01:10.903Z",
"updated_at": "2021-03-23T13:01:10.903Z",
"deleted_at": null
}
]

Get survey information

Authorizations:

ApiKeyAuth

path Parameters

surveyId

required

string

String ID of the survey to get

Responses

Response samples

200
403
500

Content type

application/json

{"id": "TN6I4tvo_",
"name": "NPS survey",
"organization_id": "testorg",
"type": "customer",
"status": "open",
"fields": [{"name": "nps",
"type": "nps",
"label": "How likely are you to recommend our\n product to a friend or colleague?"
},
{"name": "feedback",
"type": "comment",
"label": "What is the primary reason for your score?"
},
{"name": "comment",
"type": "comment",
"label": "Can we publish your feedback on our website and social media?",
"description": "You can edit your public comment here."
},
{"name": "noPublicConsent",
"type": "checkbox",
"label": "I don't want to publish my feedback"
},
{"name": "comment_video",
"type": "video"
},
{"name": "noVideoRecord",
"type": "checkbox",
"label": "I don’t want to record a video comment"
}
]
}

List embeds owned by the API key holder

Authorizations:

ApiKeyAuth

query Parameters

offset

integer <int32>

Start offset for query

Responses

Response samples

200
403
500

Content type

application/json

[{"id": "Krxo5Mgn9",
"name": "Embed 1",
"active": true
},
{"id": "7nmdQtD8R",
"name": "Embed 2",
"active": false
}
]

List widgets owned by the API key holder

Authorizations:

ApiKeyAuth

query Parameters

offset

integer <int32>

Start offset for query

Responses

Response samples

200
403
500

Content type

application/json

[{"id": "Krxo5Mgn9",
"name": "Popup widget",
"active": true,
"template_type": "popup"
},
{"id": "7nmdQtD8R",
"name": "Inpage Chatbot",
"active": false,
"template_type": "inpage"
}
]

List experiments owned by the API key holder

Authorizations:

ApiKeyAuth

query Parameters

offset

integer <int32>

Start offset for query

Responses

Response samples

200
403
500

Content type

application/json

[{"id": "experiment-1",
"name": "Which one is better",
"variants": [{"id": "7nmdQtD8R",
"name": "Popup Notification"
},
{"id": "ALF8_O09Ma",
"name": "Inpage Chatbot"
}
]
}
]

Retrieve a review connection by the ID or the slug property

Authorizations:

ApiKeyAuth

path Parameters

idOrSlug

required

string

The ID as returned by the review connection list operation or user-specified name (slug)

Responses

Response samples

200

Content type

application/json

{"id": "12345",
"slug": "my-hotel-1",
"title": "My title for my hotel",
"source": "googlemaps",
"lang": "en",
"targetId": "hotel-0001",
"targetUrl": "https://airbnb.example.com/hotels/hotel-0001/"
}

Delete a review connection by the ID or the slug property

Authorizations:

ApiKeyAuth

path Parameters

idOrSlug

required

string

The ID as returned by the review connection list operation or user-specified name (slug)

Update a review connection by the ID or the slug property

Authorizations:

ApiKeyAuth

path Parameters

idOrSlug

required

string

The ID as returned by the review connection list operation or user-specified name (slug)

Request Body schema: application/json
required

slug	string or null User-specified name for the connection (unique), or null to unset
title	string or null User-specified title for the connection (unique), or null to unset

Request samples

Payload

Content type

application/json

{"slug": "my-hotel",
"title": "My hotel in Helsinki"
}

Create a new review connection by URL or source ID

Authorizations:

ApiKeyAuth

Request Body schema: application/json
required

One of

slug	string Optional user-specified name for the review connection
title	string Optional title for the review connection
targetUrl	string The URL for the review service page. Connection parameters will be automatically parsed.

Responses

Request samples

Payload

Content type

application/json

Example

Create source with a source URL

{"slug": "my-hotel",
"targetUrl": "https://airbnb.example.com/hotels/hotel-id-123"
}

Response samples

200

Content type

application/json

{"id": "string"
}

List review connections

Authorizations:

ApiKeyAuth

Responses

Response samples

200

Content type

application/json

{"reviewConnections": [{"id": "12345",
"slug": "my-hotel-1",
"title": "My title for my hotel",
"source": "googlemaps",
"lang": "en",
"targetId": "hotel-0001",
"targetUrl": "https://airbnb.example.com/hotels/hotel-0001/"
}
]
}

Trustmary Integration API (1.0.0)

API key test

Authorizations:

Responses

Response samples

List contacts

Authorizations:

query Parameters

Responses

Response samples

Create or update contact

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

Delete contact

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

List contact lists

Authorizations:

Responses

Response samples

List surveys

Authorizations:

query Parameters

Responses

Response samples

Get survey information

Authorizations:

path Parameters

Responses

Response samples

List embeds owned by the API key holder

Authorizations:

query Parameters

Responses

Response samples

List widgets owned by the API key holder

Authorizations:

query Parameters

Responses

Response samples

List experiments owned by the API key holder

Authorizations:

query Parameters

Responses

Response samples

Retrieve a review connection by the ID or the slug property

Authorizations:

path Parameters

Responses

Response samples

Delete a review connection by the ID or the slug property

Authorizations:

path Parameters

Update a review connection by the ID or the slug property

Authorizations:

path Parameters

Request Body schema: application/jsonrequired

Request samples

Create a new review connection by URL or source ID

Authorizations:

Request Body schema: application/jsonrequired

Responses

Request samples

Response samples

List review connections

Authorizations:

Responses

Response samples

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required

Request Body schema: application/json
required