> ## 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 new timeline event type

> Create a new timeline event type template to begin sending event data to HubSpot.<br/><Warning>the `v1` and `v3` timeline events APIs are only available for app partners with existing `v1`/`v3` timeline events defined in their public app. <ul><li>If your app doesn't include any timeline events yet, requests to this endpoint will fail. Instead, you can get started on [latest version of the developer platform](/apps/developer-platform/build-apps/overview). Note that you'll need to request approval before you can define app events for your app. Learn more in the [app events overview](/apps/developer-platform/add-features/app-events/overview).</li><li>If your app includes a `v1`/`v3` timeline event, learn how to [migrate it to the developer platform](/apps/developer-platform/add-features/app-events/create-and-manage-event-types#migrate-an-existing-timeline-event-type). You don't need to request approval before migrating existing event types.</li></ul>If you're not an app partner, you can send custom event data to HubSpot using the [custom events API](/api-reference/events-manage-event-definitions-v3/guide).</Warning>

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-types
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-types:
    post:
      summary: Create a new timeline event type
      description: >-
        Create a new timeline event type template to begin sending event data to
        HubSpot.<br/><Warning>the `v1` and `v3` timeline events APIs are only
        available for app partners with existing `v1`/`v3` timeline events
        defined in their public app. <ul><li>If your app doesn't include any
        timeline events yet, requests to this endpoint will fail. Instead, you
        can get started on [latest version of the developer
        platform](/apps/developer-platform/build-apps/overview). Note that
        you'll need to request approval before you can define app events for
        your app. Learn more in the [app events
        overview](/apps/developer-platform/add-features/app-events/overview).</li><li>If
        your app includes a `v1`/`v3` timeline event, learn how to [migrate it
        to the developer
        platform](/apps/developer-platform/add-features/app-events/create-and-manage-event-types#migrate-an-existing-timeline-event-type).
        You don't need to request approval before migrating existing event
        types.</li></ul>If you're not an app partner, you can send custom event
        data to HubSpot using the [custom events
        API](/api-reference/events-manage-event-definitions-v3/guide).</Warning>
      operationId: postintegrationsv1applicationidtimelineeventtypes
      responses:
        '200':
          description: >-
            Successful response - Get the details of a specific timeline event
            type by its id
          content:
            application/json:
              schema:
                type: object
              examples:
                example1:
                  summary: Create a new Timeline Event Type - Example 1
                  value:
                    - name: New Event Type
                      applicationId: '123'
                      objectType: CONTACT
                      headerTemplate: >-
                        # Title for event {{id}}\nThis is an event for
                        {{objectType}}
                      detailTemplate: >-
                        This event happened on {{#formatDate
                        timestamp}}{{/formatDate}}
                    - id: 261
                      name: Test Event Type
                      headerTemplate: >-
                        # Title for event {{id}}\nThis is an event for
                        {{objectType}}
                      detailTemplate: >-
                        This event happened on {{#formatDate
                        timestamp}}{{/formatDate}}
                      applicationId: 123
                      objectType: CONTACT

````