---
title: "Adicionar meta avançada"
method: POST
path: "/advanced-goals"
---

# Adicionar meta avançada

`POST /advanced-goals`

## Request body

- object
  - `title` string, required — Título
  - `visibility` integer, required — Visibilidade. Opções: `1`= pública | `2`= privada | `3`= envolvidos
  - `type` integer, required — Tipo. Opções: `1`= oportunidade | `2`= atividade | `3`= forecast | `4`= proposta | `5`= ligação | `6`= assinatura
  - `goal_for` integer — Meta por. Opções: `1`= quantidade | `2`= valor | `5`= duração. Obrigatório quando `type` for: `1`, `4` ou `5`
  - `observation` string — Observação
  - `type_of_period` integer, required — Vigência da meta por. Opções: `0`= período customizado | `1`= dia | `2`= semana | `3`= duas semanas | `4`= mês | `5`= bimestre | `6`= trimestre | `7`= semestre | `8`= ano
  - `start_at` string, date, required — Inicia em (Ex.: `2025-01-01`). Padrão: `aaaa-mm-dd`
  - `end_at` string, date, required — Termina em (Ex.: `2025-01-01`). Padrão: `aaaa-mm-dd`
  - `item_criteria` integer — Filtrar por. Opções: `1`= categoria | `2`= item | `3`= tipo de item
  - `item_id` integer — ID do item. Obrigatório quando `item_criteria` for: `2`
  - `item_categories` integer[] — Array de ID de categoria do item. Obrigatório quando `item_criteria` for: `1`
  - `item_criterias` string[] — Array de tipo de item. Opções: `product`= Produto | `service`= Serviço | `mrr`= MRR | `ps`= P&S. Obrigatório quando `item_criteria` for: `3`
  - `item_criterias_in` string[] — Array de filtrar em. Opções: `proposals`= Itens da proposta | `deals`= Itens da oportunidade
  - `activity_type_id` integer — ID do tipo de atividade. Disponível quando `type` for: `2`
  - `origin_id` integer — ID da origem da oportunidade
  - `region_id` integer — ID da região/microrregião de empresa/pessoa
  - `city_id` integer — ID da cidade da empresa/pessoa
  - `state` string — UF da cidade da empresa/pessoa. Ex.: `SP`, `RJ`, `RS`
  - `segment_id` integer — ID do segmento da empresa
  - `custom_fields` object[] — Filtro de campos customizados
    - `custom_field_id` integer, required — ID do campo customizado
    - `value` string, required — Valor do filtro do campo customizado
  - `users` object[], required — Usuários
    - `user_id` integer, required — ID do usuário
    - `team_id` integer — ID da equipe
    - `value` number, float, required — Valor da meta do usuário
  - `deal_status` string[] — Array de status das oportunidades. Opções: `open`= Abertas | `closed`= Ganhas
  - `proposal_status` string[] — Array de status das propostas. Disponível quando `type` for: `4`. Opções: `open`= Aberta | `approved`= Aprovada | `sent_to_sign`= Aguardando assinatura | `signed`= Assinada
  - `deal_value_for` string[] — Array de tipo de valor. Disponível quando `type` for: `1`, `goal_for` for: `2` e `item_criteria` não for: `3`. Opções: `P&S` | `MRR`
  - `activity_status` string[] — Array de status das atividades. Disponível quando `type` for: `2`. Opções: `open`= Abertas | `done`= Concluídas
  - `call_relevance` string[] — Array de relevância da ligação. Disponível quando `type` for: `5`. Opções: `import`= Relevantes | `not_important`= Irrelevantes
  - `signature_status` string[] — Array de status das assinaturas. Disponível quando `type` for: `6`. Opções: `sent_to_sign`= Enviado para assinatura | `signed_by_all`= Assinado por todos
  - `pipelines` integer[] — Filtro de ID de funil
  - `stages` integer[] — Filtro de ID de etapa
  - `tags` integer[] — Filtro de ID de tag
  - `recurrence` object[] — Recorrência. Indisponível quando `type_of_period` for: `0`
    - `id` integer — ID da recorrência.
    - `status` integer, required — Status. Opções: `0`= inativa | `1`= ativa.
    - `repetition_type` integer, required — Repetir meta a cada. Opções: `1`= dia | `2`= semana | `3`= duas semanas | `4`= mês | `5`= bimestre | `6`= trimestre | `7`= semestre | `8`= ano.
    - `end_at` string, date, required — Termina em (Ex.: `2025-01-01`). Padrão: `aaaa-mm-dd`
    - `days_of_week` object[] — Repetir somente nesses dias. Obrigatório quando `repetition_type` for: `1`.
      - `sunday` boolean — Domingo
      - `monday` boolean — Segunda-feira
      - `tuesday` boolean — Terça-feira
      - `wednesday` boolean — Quarta-feira
      - `thursday` boolean — Quinta-feira
      - `friday` boolean — Sexta-feira
      - `saturday` boolean — Sábado
    - `update_future_goals` boolean — Atualizar metas futuras da recorrência.

## Response `200`

200

## Other responses

- `422` — 422

---

[API](https://skmtc.net/pipe/apis/application-json.md) · [All operations](https://skmtc.net/pipe/apis/application-json/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pipe/application-json/versions/0a130198f0a3/schema)