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

# Create a timeline event

> Create a new event, or update an existing event. Please see the Timeline Overview for more details about creating events. Events must include at least one identity parameter to be associated with a contact record. See the overview and the examples for more details.

export const ScopesList = ({scopes = [], description = "Esta API requer um dos seguintes escopos:"}) => {
  if (!scopes || scopes.length === 0) {
    return null;
  }
  const sortedScopes = scopes.sort((a, b) => a.localeCompare(b));
  return <div>
      <div className="text-sm mb-2">{description}</div>
      <div>
        {sortedScopes.map((scope, index) => <div key={index}>
            <code>
              <span className="text-xs">{scope}</span>
            </code>
          </div>)}
      </div>
    </div>;
};

<Accordion title="Scope requirements">
  <ScopesList scopes={['timeline']} />
</Accordion>


## OpenAPI

````yaml specs/legacy/v1/crm-timeline-v1.json POST /integrations/v1/{application}‐id/timeline/event
openapi: 3.0.0
info:
  title: CRM Timeline Events API v1
  version: 1.0.0
  description: Legacy CRM Timeline Events API v1 - Auto-generated from MDX documentation
servers:
  - url: https://api.hubapi.com
    description: HubSpot API Server
security: []
paths:
  /integrations/v1/{application}‐id/timeline/event:
    post:
      summary: Create a timeline event
      description: >-
        Create a new event, or update an existing event. Please see the Timeline
        Overview for more details about creating events. Events must include at
        least one identity parameter to be associated with a contact record. See
        the overview and the examples for more details.
      operationId: postintegrationsv1applicationidtimelineevent
      responses:
        '200':
          description: >-
            Successful response - Create a new event, or update an existing
            event
          content:
            application/json:
              schema:
                type: object
              examples:
                example1:
                  summary: Create a timeline event - Example 1
                  value:
                    - id: '3'
                      objectId: 1
                      eventTypeId: '123'
                    - id: '3'
                      email: test@test.com
                      eventTypeId: '123'
                    - id: '3'
                      utk: 89b5afb740d41f4cd6651ac5237edf09
                      eventTypeId: '123'
                    - id: '1'
                      objectId: 11
                      email: santa.claus@far.com
                      eventTypeId: '123'
                    - id: '3'
                      objectId: 1
                      eventTypeId: '123'
                      extraData:
                        name: JohnDoe
                        weather: Cloudy
                    - id: '3'
                      objectId: 1
                      eventTypeId: '123'
                      presentationId: '9876543'
                      extraData:
                        name: JohnDoe
                        weather: Cloudy
                    - id: '3'
                      objectId: 1
                      eventTypeId: '123'
                      timelineIFrame:
                        linkLabel: View external data
                        iframeLabel: Example iframe
                        iframeUri: https://example.com
                        width: 800
                        height: 300

````