> ## Documentation Index
> Fetch the complete documentation index at: https://docs.extole.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send Event

> Triggers this event for one person. It is a real event: campaigns that listen for it can issue rewards and send emails.



## OpenAPI

````yaml /feature-specific-apis/trigger-event-job.json post /v6/events/{event_name}
openapi: 3.1.0
info:
  title: Trigger Event Job
  version: 1.0.0
  description: >-
    Operations published by Extole Trigger Event Job components. Generated from
    the component contracts on my.extole.com.
servers:
  - description: Production - Extole events host
    url: https://events.extole.io
security: []
paths:
  /v6/events/{event_name}:
    post:
      summary: Send Event
      description: >-
        Triggers this event for one person. It is a real event: campaigns that
        listen for it can issue rewards and send emails.
      parameters:
        - name: event_name
          in: path
          required: true
          description: The event this trigger event listens for.
          schema:
            type: string
            enum:
              - event
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SendEventRequest'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                required:
                  - event_id
                  - person_id
                properties:
                  event_id:
                    type: string
                    description: >-
                      Identifier of the event. What it caused follows from the
                      campaign rules.
                  person_id:
                    type: string
                    description: Extole person the event resolved to.
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestExceptionResponse'
              examples:
                binding_error:
                  $ref: '#/components/examples/binding_error'
                invalid_json:
                  $ref: '#/components/examples/invalid_json'
                invalid_parameter:
                  $ref: '#/components/examples/invalid_parameter'
                missing_request_body:
                  $ref: '#/components/examples/missing_request_body'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RestExceptionResponse'
              examples:
                access_denied:
                  $ref: '#/components/examples/access_denied'
                method_unauthorized:
                  $ref: '#/components/examples/method_unauthorized'
                missing_access_token:
                  $ref: '#/components/examples/missing_access_token'
      security:
        - CLIENT_AUTH_HEADER: []
        - CLIENT_AUTH_QUERY_PARAM: []
      servers:
        - description: Production - Extole events host
          url: https://events.extole.io
components:
  schemas:
    SendEventRequest:
      description: To name the person, send person_id or email.
      type: object
      properties:
        container:
          description: >-
            Container the event goes to, for example test to keep it out of
            analytics. Without it, a request from your backend goes to
            production.
          type: string
        email:
          description: >-
            The email of the person the event is for. It is the identity key of
            the client.
          type: string
        person_id:
          description: Extole person the event is for, when you have the id.
          type: string
    RestExceptionResponse:
      type: object
      description: Represents the API error response
      properties:
        code:
          type: string
          description: Specific error code for this error type, documented per endpoint
        http_status_code:
          type: integer
          description: >-
            HTTP status code that was returned with this error, useful if client
            get response code
        message:
          type: string
          description: User readable English description of the error
        parameters:
          type: object
          description: >-
            Attributes related to the error, varies be error code, documented
            per endpoint
          additionalProperties:
            type: object
            description: >-
              Attributes related to the error, varies be error code, documented
              per endpoint
        unique_id:
          type: string
          description: >-
            Unique id associated with this error, useful for discussions with
            Extole
      required:
        - code
        - http_status_code
        - message
        - parameters
        - unique_id
  examples:
    binding_error:
      summary: binding_error
      value:
        unique_id: 00000000-0000-0000-0000-000000000000
        http_status_code: 400
        code: binding_error
        message: Argument is not of the expected type
        parameters: {}
    invalid_json:
      summary: invalid_json
      value:
        unique_id: 00000000-0000-0000-0000-000000000000
        http_status_code: 400
        code: invalid_json
        message: JSON is invalid
        parameters: {}
    invalid_parameter:
      summary: invalid_parameter
      value:
        unique_id: 00000000-0000-0000-0000-000000000000
        http_status_code: 400
        code: invalid_parameter
        message: Parameter is invalid.
        parameters: {}
    missing_request_body:
      summary: missing_request_body
      value:
        unique_id: 00000000-0000-0000-0000-000000000000
        http_status_code: 400
        code: missing_request_body
        message: Missing request body
        parameters: {}
    access_denied:
      summary: access_denied
      value:
        unique_id: 00000000-0000-0000-0000-000000000000
        http_status_code: 403
        code: access_denied
        message: >-
          The access_token provided is not permitted to access the specified
          resource.
        parameters: {}
    method_unauthorized:
      summary: method_unauthorized
      value:
        unique_id: 00000000-0000-0000-0000-000000000000
        http_status_code: 403
        code: method_unauthorized
        message: Access forbidden to this endpoint
        parameters: {}
    missing_access_token:
      summary: missing_access_token
      value:
        unique_id: 00000000-0000-0000-0000-000000000000
        http_status_code: 403
        code: missing_access_token
        message: No access_token was provided with this request.
        parameters: {}
  securitySchemes:
    CLIENT_AUTH_HEADER:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        A client access token, issued to your Extole account and used from your
        own backend. Never send a client token from a consumer device.
      x-bearer-format: bearer
    CLIENT_AUTH_QUERY_PARAM:
      type: apiKey
      in: query
      name: access_token
      description: >-
        A client access token, issued to your Extole account and used from your
        own backend. Never send a client token from a consumer device.

````

## Related topics

- [Send Event](https://docs.extole.com/api-reference/feature-specific/api-event/send-event.md)
- [Android SDK](https://docs.extole.com/technical/platform-integrations/mobile-sdks/android-sdk.md)
- [iOS SDK](https://docs.extole.com/technical/platform-integrations/mobile-sdks/ios-sdk.md)
- [Send Events from the Partner Platform](https://docs.extole.com/technical/building-partner-integrations/integration-types/partner-events-send-from-platform.md)
- [Send Event From Site or App](https://docs.extole.com/api-reference/feature-specific/tagless-cta/send-event-from-site-or-app.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.