---
title: "Create Affiliate"
method: POST
path: "/app/affiliate"
tags: ["Affiliates"]
---

# Create Affiliate

`POST /app/affiliate`

Cria um novo afiliado.

## Request body

- object
  - `name` string, required — Nome do afiliado (máximo 56 caracteres)
  - `ref_code` string, required — Código de referência único do afiliado (apenas letras, números, hífen e underscore)
  - `percent_commission` number, required — Percentual de comissão do afiliado (entre 1 e 100)
  - `email` string — Email do afiliado (opcional)
  - `min_withdraw` number — Valor mínimo para saque
  - `linked_discount_id` number — ID do cupom de desconto vinculado ao afiliado
  - `package_commissions` object[] — Comissões personalizadas por produto
    - `package_id` number, required — ID do produto
    - `percent_commission` number, required — Percentual de comissão para o produto (entre 0 e 100)
  - `withdraw_settings` object — Configurações de saque do afiliado
    - `full_name` string — Nome completo do beneficiário (máximo 100 caracteres)
    - `pix_key` string — Chave PIX (máximo 100 caracteres)
    - `pix_key_type` 'CPF' | 'CNPJ' | 'EMAIL' | 'PHONE' | 'RANDOM' — Tipo da chave PIX: `CPF`, `CNPJ`, `EMAIL`, `PHONE` ou `RANDOM`
    - `cpf_cnpj` string — CPF ou CNPJ do beneficiário (máximo 18 caracteres)

## Response `200`

OK

- object
  - `id` number
  - `store_id` number
  - `name` string
  - `ref_code` string
  - `percent_commission` number
  - `balance` number
  - `min_withdraw` number
  - `email` string
  - `self_affiliated` boolean
  - `linked_discount_id` number, nullable
  - `withdraw_settings` object, nullable
    - `full_name` string
    - `pix_key` string
    - `pix_key_type` string
    - `cpf_cnpj` string
  - `dash_secret` string
  - `package_commissions` object[]
  - `created_at` string
  - `updated_at` string

---

[API](https://skmtc.net/centralcart/apis/centralcart-api.md) · [All operations](https://skmtc.net/centralcart/apis/centralcart-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/centralcart/centralcart-api/revisions/6cbd98848375/schema)