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

# Criar atividade

> Cadastrar uma novo atividade



## OpenAPI

````yaml https://api.datacrazy.io/v1/api/openapi/v1/json post /api/v1/activities
openapi: 3.0.0
info:
  title: API CRM Datacrazy
  description: Versão 1.0 da API do CRM Datacrazy
  version: '1.0'
  contact: {}
servers:
  - url: https://api.g1.datacrazy.io
security: []
tags: []
paths:
  /api/v1/activities:
    post:
      tags:
        - Atividades
      summary: Criar atividade
      description: Cadastrar uma novo atividade
      operationId: ActivitiesV1Controller_create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateActivityDto'
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActivityDto'
      security:
        - access-token: []
components:
  schemas:
    CreateActivityDto:
      type: object
      properties:
        title:
          type: string
          example: Reunião online
          description: Título da atividade.
        description:
          type: string
          example: Negociar preços com o cliente
          description: Descrição da atividade.
        startDate:
          format: date-time
          type: string
          example: 2025-10-09T03%3A00%3A00.000Z
          description: >-
            Filtro de intervalo, negócios que estão em negociação ou estavam em
            negociação em determinado intervalo. Formato (ISO 8601):
            `YYYY-MM-DDTHH:mm:ss.sssZ`
        endDate:
          format: date-time
          type: string
          example: 2025-10-09T03%3A00%3A00.000Z
          description: >-
            Filtro de intervalo, negócios que estão em negociação ou estavam em
            negociação em determinado intervalo. Formato (ISO 8601):
            `YYYY-MM-DDTHH:mm:ss.sssZ`
        attendant:
          description: Atendente vinculado a atividade
          allOf:
            - $ref: '#/components/schemas/AttendantDto'
        required:
          type: boolean
          example: 'false'
          description: Valor boneano que indica se a atividade é obrigatória ou não
        lead:
          description: Lead a ser vinculado a atividade
          allOf:
            - $ref: '#/components/schemas/LeadSummary'
        linkToStage:
          type: boolean
          example: 'true'
          description: >-
            Valor boneano que indica se a atividade deve ser vinculada a etapa
            do negócio ou não
        business:
          description: Negócio a ser vinculado a atividade
          allOf:
            - $ref: '#/components/schemas/BusinessSummaryDto'
        activityType:
          description: Tipo de atividade.
          allOf:
            - $ref: '#/components/schemas/ActivityTypeSummaryDto'
        flow:
          description: Automação vinculada a atividade.
          allOf:
            - $ref: '#/components/schemas/FlowSummaryDto'
      required:
        - title
        - lead
    ActivityDto:
      type: object
      properties:
        id:
          type: string
          example: e9a09677-cf00-4d84-aa12-6d78d6786555
          description: ID da atividade.
        createdAt:
          format: date-time
          type: string
          example: '2025-06-18T22:18:36.666Z'
          description: Data de criação da atividade.
        title:
          type: string
          example: Reunião online
          description: Título da atividade.
        description:
          type: string
          example: Negociar preços com o cliente
          description: Descrição da atividade.
        startDate:
          format: date-time
          type: string
          example: 2025-10-09T03%3A00%3A00.000Z
          description: >-
            Filtro de intervalo, negócios que estão em negociação ou estavam em
            negociação em determinado intervalo. Formato (ISO 8601):
            `YYYY-MM-DDTHH:mm:ss.sssZ`
        endDate:
          format: date-time
          type: string
          example: 2025-10-09T03%3A00%3A00.000Z
          description: >-
            Filtro de intervalo, negócios que estão em negociação ou estavam em
            negociação em determinado intervalo. Formato (ISO 8601):
            `YYYY-MM-DDTHH:mm:ss.sssZ`
        isCompleted:
          type: boolean
          example: 'true'
          description: Valor boneano que indica se a atividade está concluida ou não
        lead:
          example: 2025-10-09T03%3A00%3A00.000Z
          description: Lead vinculado a atividade
          allOf:
            - $ref: '#/components/schemas/LeadDto'
        business:
          description: Negócio vinculado a atividade
          allOf:
            - $ref: '#/components/schemas/BusinessDto'
        attendant:
          description: Atendente vinculado a atividade
          allOf:
            - $ref: '#/components/schemas/AttendantDto'
        activityType:
          description: Tipo da atividade
          allOf:
            - $ref: '#/components/schemas/ActivityTypeDto'
        required:
          type: boolean
          example: 'false'
          description: Valor boneano que indica se a atividade é obrigatória ou não
        flow:
          description: Automação vinculada a atividade
          allOf:
            - $ref: '#/components/schemas/FlowDto'
      required:
        - title
    AttendantDto:
      type: object
      properties:
        userId:
          type: string
          description: ID do usuário
          example: t9kn9mqPakdGG535GQK3hod8wzM2
        id:
          type: string
          description: ID do usuário como atendente (ID do atendente)
          example: 6807e48c25ece34f9f1ba7dd
        name:
          type: string
          description: Nome do atendente
          example: Joao Silva
        email:
          type: string
          description: Email do atendente
          example: joaosilva@gmail.com
        phone:
          type: string
          description: Telefone do atendente
          example: '5547991331190'
        imageURL:
          type: string
          description: Url da imagem do atendente
          example: >-
            https://dc-qqqq1111pb.s3.amazonaws.com/profiles/koQGLa8p68fNZiiSmE1tec2LHtc2_2025-05-24T00%3A27%3A23.486Z
    LeadSummary:
      type: object
      properties:
        id:
          type: string
          example: 15b41959-b04d-4a99-b878-6e45fffa7633
          description: Id do lead
    BusinessSummaryDto:
      type: object
      properties:
        id:
          type: string
          example: e9a09677-cf00-4d84-aa12-6d78d6786555
          description: ID do negócio.
    ActivityTypeSummaryDto:
      type: object
      properties:
        id:
          type: string
          example: e9a09677-cf00-4d84-aa12-6d78d6786555
          description: ID do tipo de atividade.
    FlowSummaryDto:
      type: object
      properties:
        id:
          type: string
          example: 8fcd6ff0-6b45-40e3-8e7d-abd456a5a459
          description: ID da automação.
    LeadDto:
      type: object
      properties:
        id:
          type: string
          example: 15b41959-b04d-4a99-b878-6e45fffa7633
          description: Id do lead
        createdAt:
          format: date-time
          type: string
          example: '2025-06-11T18:31:25.203Z'
          description: Data de criação do lead
        name:
          type: string
          example: Guilherme Gavazzoni
          description: Nome do lead
        image:
          type: string
          example: >-
            https://dc-qqqq2222pb.s3.amazonaws.com/0a7ac87c-2f50-46b5-9c39-80ffec53e633/1163f5c2-62f4-443f-a84f-9c223b05ae3b
          description: Url da Imagem do lead
        phone:
          type: string
          example: +55 (47) 991331190
          description: Telefone do lead
        rawPhone:
          type: string
          example: '5547991331190'
          description: Telefone do lead (apenas números)
        email:
          type: string
          example: guilherme@datacrazy.com.br
          description: Email do lead
        source:
          type: string
          example: Google ads
          description: Origem do lead
        company:
          type: string
          example: Apple
          description: Empresa do lead
        taxId:
          type: string
          example: 108.154.702-92
          description: Documento de identificação
        site:
          type: string
          example: www.meulead.com.br
          description: Site do lead
        instagram:
          type: string
          example: '@guilhermegavazzoni'
          description: Instagram do lead
        address:
          example:
            zip: 88338-130
            address: Avenida Brasil
            block: Centro
            city: Balneário Camboriú
            state: SC
            country: BR
          description: Endereço vinculado ao lead
          allOf:
            - $ref: '#/components/schemas/LeadAddressDto'
        tags:
          example:
            id: 849fefab-e697-4720-9303-e788c23790cc
            name: IA
            color: '#DC2626'
            description: Leads IA
            createdAt: '2025-06-12T17:37:17.861Z'
          description: ID das tags atreladas ao lead
          allOf:
            - $ref: '#/components/schemas/TagDto'
        lists:
          example:
            - id: 5343afav-e697-4720-9303-e788c23711dd
              name: ativos
              color: '#EB2626'
              description: lista de compradores recorrentes
              createdAt: '2025-06-12T17:37:17.861Z'
            - id: f2b3c92d-3843-406f-a3e3-672d2d7d2a27
              name: inativos
              color: '#EB2626'
              description: lista de compradores de baixa frequência
              createdAt: 2025-12-03T17:28:09:5361Z
          description: Array de listas atreladas ao lead
          type: array
          items:
            type: string
        contacts:
          example:
            - platform: EMAIL
              contactId: 853b46db8ae664237d89dd6
              lastContactStatus: null
            - platform: WHATSAPP
              contactId: '555491664460'
              lastContactStatus:
                platform: WHATSAPP
                contactId: '555491664460'
                instanceId: 681bb0510fe99d126e7c6b7b
                isPending: true
                lastReceivedMessage:
                  messageId: 684c13db8ae7797307d83cc3
                  date: '2025-06-13T12:04:48.218Z'
                  errorCode: null
                lastSendedMessage:
                  messageId: 684c13c28ae7797307d83bc4
                  date: '2025-06-13T12:04:23.511Z'
                  errorCode: null
          description: Array de contatos atrelados ao lead
          allOf:
            - $ref: '#/components/schemas/LeadContactDto'
        metrics:
          example:
            purchaseCount: 1
            lastPurchaseDate: '2025-06-04T19:34:55.535Z'
            averageTicket: 14040
            totalSpent: 21080
            openBusinessesCount: 4
            lostBusinessesCount: 1
            lostBusinessesTotalValue: 7800
            purchaseFrequency: 3
          description: Métricas referentes ao lead
          allOf:
            - $ref: '#/components/schemas/LeadMetricsDto'
        attendant:
          description: Atual atendente do lead
          example:
            userId: 86BshEbu5WY94ZOB8beUvk1y7tF2
            id: 6cc8c79c-a0c8-4293-a4a0-d7e730aff7c7
            name: Joao da Silva
            email: joao@hotmail..com
            phone: '554791331190'
            image: >-
              https://dc-qqqq2222pb.s3.amazonaws.com/d129a692-e5ab-42b3-b0e4-90ad9a12b068/b1d045df-3a26-4e54-8d3f-7df4df5e2f08
          allOf:
            - $ref: '#/components/schemas/AttendantDto'
        sourceReferral:
          description: Fonte de referencia do lead
          allOf:
            - $ref: '#/components/schemas/SourceReferralDto'
    BusinessDto:
      type: object
      properties:
        id:
          type: string
          example: e9a09677-cf00-4d84-aa12-6d78d6786555
          description: ID do negócio.
        createdAt:
          format: date-time
          type: string
          example: '2025-06-18T22:18:36.666Z'
          description: Data de criação do negócio.
        stageId:
          type: string
          example: e6803a51-4bd6-416b-b516-3622ff256732
          description: ID do estágio atual do negócio.
        leadId:
          type: string
          example: c1152508-fdfd-4905-a3f4-f3850cc00bf0
          description: ID do lead associado ao negócio.
        attendantId:
          type: string
          example: 7e7da46a-a0ed-43c2-a3aa-3ac253f41b4d
          description: ID do atendente responsável pelo negócio.
        nextActivityId:
          type: string
          example: 3d3d23a-a0ed-43c2-a3aa-3ac23433f41g01
          description: ID da próxima atividade relacionada ao negócio.
        total:
          type: number
          example: '70000'
          description: Valor total do negócio.
        discount:
          type: number
          example: 500
          description: Valor de desconto aplicado ao negócio.
        addition:
          type: number
          example: 0
          description: Valor de acréscimos aplicados ao negócio.
        shipping:
          type: number
          example: 2000
          description: Valor do frete relacionado ao negócio.
        coupon:
          type: string
          example: CUPOM100
          description: Cupom de desconto utilizado no negócio.
        shippingType:
          type: string
          example: Sedex
          description: Tipo de frete selecionado para o negócio.
        status:
          type: string
          example: in_process
          description: Status atual do negócio.
        code:
          type: number
          example: 50607
          description: Código interno do negócio.
        externalId:
          type: string
          example: f33420908-dcdc-4905-a3f4-f3850cc43bf0
          description: ID externo vinculado ao negócio.
        lastMovedAt:
          format: date-time
          type: string
          example: '2025-06-18T22:18:36.611Z'
          description: Data da última movimentação do negócio.
        statusChangedAt:
          format: date-time
          type: string
          example: 2025-06-18T22:20:14.611Z4
          description: Data da última alteração do status do negócio.
        products:
          example: []
          description: Lista de produtos associados ao negócio.
          type: array
          items:
            $ref: '#/components/schemas/BusinessProductDto'
        lossReasonId:
          type: string
          example: 'null'
          description: ID do motivo de perda do negócio.
        justification:
          type: string
          example: ''
          description: Justificativa associada ao negócio.
        productsCount:
          type: number
          example: 2
          description: Quantidade total de produtos no negócio.
    ActivityTypeDto:
      type: object
      properties:
        id:
          type: string
          example: e9a09677-cf00-4d84-aa12-6d78d6786555
          description: ID do tipo de atividade.
        name:
          type: string
          example: Reunião presencial
          description: Nome do tipo de atividade.
        color:
          type: string
          description: Cor do tipo de atividade em formato hexadecimal
          example: '#FF2200'
    FlowDto:
      type: object
      properties:
        id:
          type: string
          example: 8fcd6ff0-6b45-40e3-8e7d-abd456a5a459
          description: ID da automação.
        name:
          type: string
          example: Fluxo de mensagens de boas-vindas
          description: Nome da automação.
        description:
          type: string
          example: Automação disparada para clientes não cadastrados na base
          description: Descrição da automação.
        createdAt:
          format: date-time
          type: string
          example: '2025-09-09T16:27:15.522Z'
          description: Data de criação da automação.
        updatedAt:
          format: date-time
          type: string
          example: '2025-09-09T16:27:15.522Z'
          description: Data da última atualização da automação.
        group:
          type: string
          example: '1'
          description: Grupo do fluxo.
        active:
          type: boolean
          example: false
          description: Valor booleano que indica se a automação está ativa.
    LeadAddressDto:
      type: object
      properties:
        zip:
          type: string
          description: Código postal do lead
        address:
          type: string
          description: Endereço do lead
        block:
          type: string
          description: Bairro do lead
        city:
          type: string
          description: Cidade do lead
        state:
          type: string
          description: Estado do lead
        country:
          type: string
          description: País do lead
        number:
          type: string
          description: Número da residência do lead
    TagDto:
      type: object
      properties:
        id:
          type: string
          description: ID da tag
          example: cb3e8d24-ccad-43d1-acd5-08580d9bc674
        name:
          type: string
          description: Nome da tag
          example: marketing orgânico
        color:
          type: string
          description: Cor da tag em hexadecimal
          example: '#A78BFA'
        description:
          type: string
          description: Descrição atribuída a tag
          example: Leads que vieram de campanhas internas
        createdAt:
          format: date-time
          type: string
          description: Data de cricão da tag
          example: '2025-03-25T14:12:47.738Z'
    LeadContactDto:
      type: object
      properties: {}
    LeadMetricsDto:
      type: object
      properties:
        purchaseCount:
          type: number
          description: Quantidade de compras realizadas pelo lead
        lastPurchaseDate:
          format: date-time
          type: string
          description: Data da ultima compra realizada
        averageTicket:
          type: number
          description: Ticket médio
        totalSpent:
          type: number
          description: Total gasto
        openBusinessesCount:
          type: number
          description: Quantiade de negócios em aberto
        lostBusinessesCount:
          type: number
          description: Quantidade de negócios perdidos
        lostBusinessesTotalValue:
          type: number
          description: Valor total dos negócios perdidos
        purchaseFrequency:
          type: number
          description: Frequência de compra
    SourceReferralDto:
      type: object
      properties:
        sourceId:
          type: string
          description: ID referente fonte
          example: 2bc3d979-93a4-4e64-8903-5d9379d3de91
        sourceUrl:
          type: string
          description: Url referente fonte
          example: https://example.com/artigo-de-origem
        ctwaId:
          type: string
          description: CTWA referente (Click to WhatsApp ID)
          example: 849fefab-e697-4720-9303-e788c23790cc
    BusinessProductDto:
      type: object
      properties:
        id:
          type: string
          example: 8cb0e554-c0a1-4eea-af71-b4909ef8b5ec
          description: Identificador único do produto no negócio.
        product:
          description: Informações do produto associado ao negócio.
          allOf:
            - $ref: '#/components/schemas/ProductDto'
        quantity:
          type: number
          example: 1
          description: Quantidade do produto no negócio.
        price:
          type: number
          example: 70
          description: Preço unitário do produto no negócio.
        total:
          type: number
          example: 70
          description: Valor total do produto no negócio (preço x quantidade).
    ProductDto:
      type: object
      properties:
        id:
          type: string
          example: 15b41959-b04d-4a99-b878-6e45fffa7633
          description: Id do produto
        id_sku:
          type: string
          example: SKU12345
          description: Id SKU do produto
        name:
          type: string
          example: Nome do Produto
          description: Nome do produto
        price:
          type: number
          example: 199.99
          description: Preço do produto
        createdAt:
          format: date-time
          type: string
          description: Data de criação do produto
  securitySchemes:
    access-token:
      scheme: bearer
      bearerFormat: JWT
      type: http

````