API V2
API V2
https://{{env}}.questionpro.com/a/api/v2/surveys/{{survey-id}}/emaillists/{{email-list-id}}/emails?apiKey={{apiKey}}
The value of environment {{env}} variable depends upon your datacenter. Refer to the Environment page for more details.
[
{
"emailAddress": "jane.doe@emaildomain.com",
"firstname": "Jane",
"lastname": "Doe",
"custom1": "WA",
"custom2": "Sales",
"custom3": "EID987",
"custom4": "",
"custom5": "",
"highCustomVariables": {
"custom8": "Product A",
"custom10": "Department X"
}
},
{
"emailAddress": "john.doe@emaildomain.com",
"firstname": "John",
"lastname": "Doe",
"custom1": "WA",
"custom2": "Sales",
"custom3": "EID986",
"custom4": "",
"custom5": "",
"highCustomVariables": {
"custom8": "Product A",
"custom10": "Department Z"
}
}
]
curl --request POST \
--url 'https://{{env}}.questionpro.com/a/api/v2/surveys/{{survey-id}}/emaillists/{{email-list-id}}/emails?apiKey={{apiKey}}' \
--header 'Content-Type: application/json' \
--data '[
{
"emailAddress": "jane.doe@emaildomain.com",
"firstname": "Jane",
"lastname": "Doe",
"custom1": "WA",
"custom2": "Sales",
"custom3": "EID987",
"custom4": "",
"custom5": "",
"highCustomVariables": {
"custom8": "Product A",
"custom10": "Department X"
}
},
{
"emailAddress": "john.doe@emaildomain.com",
"firstname": "John",
"lastname": "Doe",
"custom1": "WA",
"custom2": "Sales",
"custom3": "EID986",
"custom4": "",
"custom5": "",
"highCustomVariables": {
"custom8": "Product A",
"custom10": "Department Z"
}
}
]
import requests
url = "https://{{env}}.questionpro.com/a/api/v2/surveys/{{survey-id}}/emaillists/{{email-list-id}}/emails"
querystring = {"apiKey":"{{apiKey}}"}
payload = "[{\"emailAddress\":\"jane.doe@emaildomain.com\",\"firstname\":\"Jane\",\"lastname\":\"Doe\",\"custom1\":\"WA\",\"custom2\":\"Sales\",\"custom3\":\"EID987\",\"custom4\":\"\",\"custom5\":\"\",\"highCustomVariables\":{\"custom8\":\"Product A\",\"custom10\":\"Department X\"}},{\"emailAddress\":\"john.doe@emaildomain.com\",\"firstname\":\"John\",\"lastname\":\"Doe\",\"custom1\":\"WA\",\"custom2\":\"Sales\",\"custom3\":\"EID986\",\"custom4\":\"\",\"custom5\":\"\",\"highCustomVariables\":{\"custom8\":\"Product A\",\"custom10\":\"Department Z\"}}]"
headers = {'Content-Type': 'application/json'}
response = requests.request("POST", url, data=payload, headers=headers, params=querystring)
print(response.text)
{
"response": [
{
"addressID": 100000075,
"emailAddress": "jane.doe@emaildomain.com",
"firstname": "Jane",
"lastname": "Doe",
"emailListID": 1000002,
"custom1": "WA",
"custom2": "Sales",
"custom3": "EID987",
"custom4": "",
"custom5": "",
"creationDate": "Mon 23 Nov, 22:11:41 GMT 2020",
"highCustomVariables": {
"custom8": "Product A",
"custom10": "Department X"
}
},
{
"addressID": 100000076,
"emailAddress": "john.doe@emaildomain.com",
"firstname": "John",
"lastname": "Doe",
"emailListID": 1000002,
"custom1": "WA",
"custom2": "Sales",
"custom3": "EID986",
"custom4": "",
"custom5": "",
"creationDate": "Mon 23 Nov, 22:11:41 GMT 2020",
"highCustomVariables": {
"custom8": "Product A",
"custom10": "Department Z"
}
}
]
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "null"
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "BAD_REQUEST",
"httpStatusCode": 400,
"id" : "1000",
"message": "Invalid URL parameters",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "UNAUTHORIZED",
"httpStatusCode": 401,
"id" : "1010",
"message": "Incorrect API Key",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "FORBIDDEN",
"httpStatusCode": 403,
"id" : "1013",
"message": "The user does not have permission to access the resource",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "NOT_FOUND",
"httpStatusCode": 404,
"id" : "1040",
"message": "The resource that you're trying to access doesn't exist",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}
{
"response": {
"error": {
"docs": www.questionpro.com/api/error-codes.html
"name": "INTERNAL_SERVER_ERROR",
"httpStatusCode": 500,
"id" : "1026",
"message": "We are not able to process your request",
"resourceUrl":"resource_url"
}
}
}
{
"$schema": "http://json-schema.org/draft-06/schema# ",
"type": "object",
"properties": {
"response": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"docs": {
"type": "string"
},
"resourceUrl": {
"type": "string"
},
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"message": {
"type": "string"
},
"httpStatusCode": {
"type": "integer"
}
},
"additionalProperties": false,
"required": [
"docs",
"resourceUrl",
"name",
"id",
"message",
"httpStatusCode"
]
}
},
"additionalProperties": false,
"required": [
"error"
]
}
},
"additionalProperties": false,
"required": [
"response"
]
}