Enable webhooks for your surveys

On the settings page scroll down to Webhooks and click on Add new. Add a name, add the endpoint, and select which events you want to subscribe to. You can also create the webhook through the API.

Attributes

survey_id string

• Unique identifier for the survey.

survey_name string

• Name of the survey.

answer_id string

• Unique identifier for the given answer.

answer_values object

• Contains all the answers that the user gave.

nps integer

• Answer data of question "How likely are you to recommend our service to a friend or colleague?" On a scale of 0-10.

custom object

• If your survey had custom questions their answers will be listed here as key value pairs. Keys are question ids, values can be answer ids, strings or arrays if the question had multiple selection answers.

feedback string

• Answer data of question "What is the primary reason for your score?"

comment string

• Answer todata ofquestion "Do you want to give your feedback publicly?". This answer is used as the public recommendation.

name string

• Answer data of question "Your name"

email string

• Answer data of question "E-mail (not displayed)"

location string

• Answer data of question "Location"

organization string

• Answer data of question "Organization"

imageFilename string

• Answer data of question "Profile picture". This picture can be accessed, with parameters w=width and h=height from https://d3hwc7twidb4ye.cloudfront.net/w128-h128-c/survey/[imageFilename]

publicConsent string

• Answer data of question "I want to publish my feedback. I have read the [Companys] privacy policy". Will be "true" or "".

noPublicConsent string

• Answer data of question "I don't want to publish my feedback". Will be "true" or "".

created_at ISO 8601 with timezone

• Time when the first page was submitted.

organization_id string

• Unique identifier for the organization.

contact contact_object

• Contains a contact_object if answer link contained an identifier.

{     
	"answer": {
    	"survey_id": "tmetCfXyD",
        "survey_name": "Survey Name",
        "answer_id": "1lwBnVbM4",
        "created_at": "2021-01-26T11:46:01.815Z",
        "answer_url": "https://app.trustmary.com/survey/tmetCfXyD/responses?				answer_id=1lwBnVbM4",
        "contactName": "Person Name",
        "contactEmail": "[email protected]",
        "contactPhone": "+35850123456789",
        "contactConsent": "true",
        "noNegativeContact": false,
        "nps": 10,
        "question_NdfJASMGj": [
        	"Toyota",
            "Mercedes"           
       ],           
       	"feedback": "I gave 10 because the product is awesome!\n",
        "question__VmZtTZ1_": "I have a silver car.",
        "question_x5MS9K6Wm": "My car has 4 wheels.",
   },
   "contact": {},
   "review": {             
   			"review_id": "zkHIUR2NZ",
            "source": "trustmary",
            "published": false,
            "eid": "1lwBnVbM4",
            "published_at": null,
            "created_at": "2021-01-26T11:46:22.088Z",
            "deleted_at": null,
            "updated_at": "2021-01-26T11:46:22.088Z",
            "reviewNps": 8,
            "personName": "Person Name",
            "commentText": "I really loved the product!" 
     },     "organization_id": "5S1I9ACyt",
     		"event": "surveyAnswerComplete"
}

Get Webhooks

GET /webhooks

Returning

{    
	"webhooks": [        
    	{       "id": "jaIdsaj2Yw",
        		"name": "Webhook example",
                "hookUrl": "https://hooks.zapier.com/hooks/catch/1231123/asdk123/",
                "events": [
                  	"surveyAnswerComplete"            
                 ],            
                 "created_at": "2021-01-18T12:01:30.262Z",
                 "disabled": null        
            },        
            {            
              	 "id": "asd1231dv",
                 "name": "Webhook created by Zapier",
                 "hookUrl": "https://hooks.zapier.com/hooks/standard/490123/as1231280398098123/",
                 "events": [                
                 	"surveyAnswerComplete"            
                 ],            
                 "created_at": "2021-09-27T07:21:07.394Z",
                 "disabled": false        
         }   
    ]
}

Create Webhook

POST /webhooks

Body

{  
	"name": "Nimi",
    hookUrl: "https://webhook.site/fddb13f8-5589-4f05-8b0c-d39730547443",
    events: ["surveyAnswerComplete"]
}

Remove Webhook

DELETE /webhooks/:webhook_id

Get webhook example data

GET /webhooks/example

Updated on: 28/02/2025