Create participant

POST/participants

Creates a new participant and associates it with a ticket. This is an authenticated route.

Headers

  • x-api-keystringrequired

    Api key provided on integrations tab in Easyflow platform.

  • x-api-secretstringrequired

    Api Secret provided on integrations tab in Easyflow platform.

Request bodyrequired

Content typeapplication/jsonobject

  • namestringrequired
  • emailstringrequired
  • phoneobject

    Optional. When sent, areaCode, ddd and number are required and must form a valid phone number.

    Show child attributesHide child attributes
    • areaCodestringrequired
    • dddstringrequired
    • numberstringrequired
    • isMobileboolean
  • documentobject

    Optional. When sent, it must be a valid document.

    Show child attributesHide child attributes
    • typestring

      Possible values:CPFRGCNPJCNHINTERNATIONAL_ID

    • numberstring
  • ticketIdstring · uuidrequired
  • internationalIdstring

Responses

200Participant successfully created.

Participant successfully created.

Content typeapplication/jsonobject

  • statusCodeinteger

    Example:200

  • dataobject
    Show child attributesHide child attributes
    • participantobject
      Show child attributesHide child attributes
      • idstring
      • namestring
      • emailstring
      • phoneobject
        Show child attributesHide child attributes
        • areaCodestring
        • dddstring
        • numberstring
        • isMobileboolean
      • documentobject
        Show child attributesHide child attributes
        • typestring

          Possible values:CPFRGCNPJCNHINTERNATIONAL_ID

        • numberstring
      • internationalIdstring
400If the provided parameter is invalid, the API will return the following error response:

If the provided parameter is invalid, the API will return the following error response:

Content typeapplication/jsonobject

  • messagestring

    Invalid param: []

    Example:Invalid param: []

  • errorstring

    Bad Request

    Example:Bad Request

  • statusCodeinteger

    400

    Example:400

  • errorCodestring

    Code that identifies the error. Present only on some errors.

401If the request is unauthorized, the API will return the following error response:

If the request is unauthorized, the API will return the following error response:

Content typeapplication/jsonobject

  • messagestring

    Invalid field

    Example:Unauthorized

  • errorstring

    Unauthorized

    Example:Unauthorized

  • statusCodeinteger

    401

    Example:401

403If the request is forbidden, the API will return the following error response:

If the request is forbidden, the API will return the following error response:

Content typeapplication/jsonobject

  • messagestring

    Forbidden resource

    Example:Forbidden resource

  • errorstring

    Forbidden

    Example:Forbidden

  • statusCodeinteger

    403

    Example:403

500If an unexpected condition occurs and the server cannot process the request, the API will return the following error response. This response has no error field.

If an unexpected condition occurs and the server cannot process the request, the API will return the following error response. This response has no error field.

Content typeapplication/jsonobject

  • statusCodeinteger

    HTTP status code.

    Example:500

  • messagestring

    Explanation of the error.

    Example:Internal Server Error