---
updatedAt: 2025-06-12T10:17:42.000Z
agentTools:
  projectIndex: https://docs.zenloop.com/llms.txt
---

# Create Answer (Email Embed)

This endpoint is used for creating a new answer for Email Embed Survey

```json
{  
    "response": "Great product with awesome quality and quick delivery.",
    "identity": "123",
    "identity_type": "custom",
    "first_name": "Maxine",
    "last_name": "Jacobs"
}
```

\##Response attributes

| Attribute                               |  Type  | Description                                                                           |
| :-------------------------------------- | :----: | :------------------------------------------------------------------------------------ |
| **answer**                              | object | Answer information data.                                                              |
| answer.**id**                           | string | Answer identifier.                                                                    |
| answer.**score\_type**                  | string | Score type for the answer.                                                            |
| answer.**score**                        | number | Actual score for the answer.                                                          |
| answer.**sentiment**                    | number | Overall sentiment of the answer.                                                      |
| answer.**sentiment\_per\_label\_name**  | object | Sentiment of the specific label.                                                      |
| answer.**name**                         | string | Name of survey recipient who submitted the answer.                                    |
| answer.**recipient\_id**                | string | ID of a recipient who submitted the answer.                                           |
| answer.**property\_ids**                |  array | Array of property identifiers for the answer.                                         |
| answer.**labels**                       |  array | List of labels for the answer.                                                        |
| answer.**labels\_with\_keywords**       | object | Label names with keywords.                                                            |
| answer.**inserted\_at**                 |  date  | Date when an answer has been submitted.                                               |
| answer.**email**                        | string | Email of survey recipient who submitted the answer. `Deprecated`                      |
| answer.**identity**                     | string | Identity of survey recipient who submitted the answer.                                |
| answer.**identity\_type**               | string | Identity type of survey recipient who submitted the answer. One of: `email`, `custom` |
| answer.**comment**                      | string | Answer comment of survey recipient who submitted the answer.                          |
| answer.**translated\_comment**          | string | Translated comment.                                                                   |
| answer.**additional\_questions**        | object | Additional answers - questions with answers.                                          |
| answer.**survey**                       | object | Survey information                                                                    |
| answer.survey.**additional\_questions** | object | Additional questions - for newly created answer.                                      |

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.zenloop.com"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/v1/response/{survey_id}/email_embed/{answer_score}": {
      "post": {
        "summary": "Create Answer (Email Embed)",
        "description": "This endpoint is used for creating a new answer for Email Embed Survey",
        "operationId": "create-answer-email-embed",
        "parameters": [
          {
            "name": "survey_id",
            "in": "path",
            "description": "Unique ID of a survey",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "Bearer <token>"
            }
          },
          {
            "name": "answer_score",
            "in": "path",
            "description": "Answer score",
            "schema": {
              "type": "integer",
              "format": "int32"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "response": {
                    "type": "string",
                    "description": "Answer comment of survey recipient who submitted the answer."
                  },
                  "identity": {
                    "type": "string",
                    "description": "Identity of survey recipient who submitted the answer."
                  },
                  "identity_type": {
                    "type": "string",
                    "description": "Identity type of survey recipient who submitted the answer. One of: `email`, `custom`"
                  },
                  "first_name": {
                    "type": "string",
                    "description": "First name of survey recipient who submitted the answer."
                  },
                  "last_name": {
                    "type": "string",
                    "description": "Last name of survey recipient who submitted the answer."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "201",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"answer\": {\n        \"additional_questions\": {},\n        \"comment\": \"Great product with awesome quality and quick delivery.\",\n        \"id\": \"MVlSblE2aDNMOXFHMExrSVh6WElvNGUrZ1FUWEI2Q3RFQ2pOaWhzZFlRbz0=\",\n        \"identity\": \"123\",\n        \"identity_type\": \"custom\",\n        \"inserted_at\": null,\n        \"labels\": [],\n        \"labels_with_keywords\": {},\n        \"metatags\": {},\n        \"name\": \"Maxine Jacobs\",\n        \"property_ids\": [],\n        \"recipient_id\": \"YkpKdGdqT1hTem5OYkU3WnRHK2NENXlPRE01NnIzVTNXdU5nbGdNZERpRT0=\",\n        \"score\": 10,\n        \"score_type\": \"promoter\",\n        \"sentiment\": null,\n        \"sentiment_per_label_name\": {},\n        \"survey_public_hash_id\": \"Q3JsUGZaVHlMRWxVQlNEeE5qNng0SEk2VWtvS01Ud2QzNldBRU9Va0NvST0=\",\n        \"translated_comment\": null,\n        \"survey\": {\n          \"additional_questions\": {\n           \"id\": \"T1RsbE5ETm1OemN0TldJMk9DMDBORFJrTFRnNFlqRXRZelk1TldabFpEWTVaakZp\",\n           \"inserted_at\": \"2023-01-19T08:04:02Z\",\n           \"options\": [\"option1\", \"option2\"],\n           \"question\": \"Some additional question [1]\",\n           \"type\": \"single_select\",\n           \"updated_at\": \"2023-01-19T08:04:02Z\" \n          }\n        }\n    }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "answer": {
                      "type": "object",
                      "properties": {
                        "additional_questions": {
                          "type": "object",
                          "properties": {}
                        },
                        "comment": {
                          "type": "string",
                          "example": "Great product with awesome quality and quick delivery."
                        },
                        "id": {
                          "type": "string",
                          "example": "MVlSblE2aDNMOXFHMExrSVh6WElvNGUrZ1FUWEI2Q3RFQ2pOaWhzZFlRbz0="
                        },
                        "identity": {
                          "type": "string",
                          "example": "123"
                        },
                        "identity_type": {
                          "type": "string",
                          "example": "custom"
                        },
                        "inserted_at": {},
                        "labels": {
                          "type": "array"
                        },
                        "labels_with_keywords": {
                          "type": "object",
                          "properties": {}
                        },
                        "metatags": {
                          "type": "object",
                          "properties": {}
                        },
                        "name": {
                          "type": "string",
                          "example": "Maxine Jacobs"
                        },
                        "property_ids": {
                          "type": "array"
                        },
                        "recipient_id": {
                          "type": "string",
                          "example": "YkpKdGdqT1hTem5OYkU3WnRHK2NENXlPRE01NnIzVTNXdU5nbGdNZERpRT0="
                        },
                        "score": {
                          "type": "integer",
                          "example": 10,
                          "default": 0
                        },
                        "score_type": {
                          "type": "string",
                          "example": "promoter"
                        },
                        "sentiment": {},
                        "sentiment_per_label_name": {
                          "type": "object",
                          "properties": {}
                        },
                        "survey_public_hash_id": {
                          "type": "string",
                          "example": "Q3JsUGZaVHlMRWxVQlNEeE5qNng0SEk2VWtvS01Ud2QzNldBRU9Va0NvST0="
                        },
                        "translated_comment": {},
                        "survey": {
                          "type": "object",
                          "properties": {
                            "additional_questions": {
                              "type": "object",
                              "properties": {
                                "id": {
                                  "type": "string",
                                  "example": "T1RsbE5ETm1OemN0TldJMk9DMDBORFJrTFRnNFlqRXRZelk1TldabFpEWTVaakZp"
                                },
                                "inserted_at": {
                                  "type": "string",
                                  "example": "2023-01-19T08:04:02Z"
                                },
                                "options": {
                                  "type": "array",
                                  "items": {
                                    "type": "string",
                                    "example": "option1"
                                  }
                                },
                                "question": {
                                  "type": "string",
                                  "example": "Some additional question [1]"
                                },
                                "type": {
                                  "type": "string",
                                  "example": "single_select"
                                },
                                "updated_at": {
                                  "type": "string",
                                  "example": "2023-01-19T08:04:02Z"
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"error\": {\n    \"status\": 401,\n    \"code\": \"UNAUTHORIZED\",\n    \"title\": \"Invalid or expired token.\"\n  }\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "status": {
                          "type": "integer",
                          "example": 401,
                          "default": 0
                        },
                        "code": {
                          "type": "string",
                          "example": "UNAUTHORIZED"
                        },
                        "title": {
                          "type": "string",
                          "example": "Invalid or expired token."
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n\t\"error\": [\n  \t{\n    \t\"details\": \"Survey Not Found\"\n    }\n\t]\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "details": {
                            "type": "string",
                            "example": "Survey Not Found"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```