---
title: "Crear Subscription"
method: POST
path: "/subscriptions"
---

# Crear Subscription

`POST /subscriptions`

## Headers

- `x-account-key` string

## Request body

- object
  - `customer` string, required — ID del Customer entregado en su creación. No es posible cambiar el Customer de una Subscription ya creada
  - `product_id` string, required — Identificador interno del producto que genera el Invoice. Puede ser un número de contrato o de propuesta. Debe ser único por Cuenta de cobro.
  - `pac_mandate_id` string — Identificador del mandato que se pondrá al inscribir un PAC.
  - `receipt_product_code` string — Clave del producto o servicio para emitir una factura del SAT. Aplica solo para módulo de facturación México.
  - `metadata` string, json — Valores adicionales específicos de cada producto. Son tratados como valores de texto y que no pueden tener más de 256 caracteres cada uno. Debes agregarlos en la webapp de Toku antes de poder utilizarlos aquí.
  - `is_recurring` boolean — Parámetro que permite crear invoices todos los meses automáticamente. Importante: Al crear invoices automáticamente, estas se crean tomando en cuenta la moneda de la account asociada.
  - `due_day` integer — Día del mes para la fecha de vencimiento. Solo aplica en caso de que is_recurring sea true.
  - `amount` number, float — Monto de la deuda que se generará automáticamente. Solo aplica en caso que is_recurring sea true.
  - `frequency` 'daily' | 'weekly' | 'monthly' | 'yearly' — Cada cuanto se cobra en deudas generadas automáticamente, se usa en conjunto a interval. Solo aplica en caso que is_recurring sea true. Ejemplos: Cobrar mensualmente - frequency = 'monthly' - interval = 1 Cobrar semestralmente - frequency = 'monthly' - interval = 6
  - `interval` integer — Multiplicador de cada cuanto se cobra en deudas generadas automáticamente, se usa en conjunto a frequency. Solo aplica en caso que is_recurring sea true.
  - `creation_lead_days` integer — Cuantos días antes del due_day se genera la deuda. Solo aplica en caso que is_recurring sea true
  - `end_date` string, date — Fecha en la que finaliza automáticamente la suscripción y deja de generar deudas. Solo aplica en caso que is_recurring sea true.
  - `max_active_invoices` integer — Cantidad máxima de invoices no pagadas que puede tener una suscripción antes de que pause automáticamente su generación de deudas. Solo aplica en caso que is_recurring sea true.
  - `currency_code` string — Código de la currency a utilizar para deudas generadas automáticamente, si no se entrega se usa el valor por defecto de la account. Solo aplica en caso que is_recurring sea true

## Response `200`

200

- object
  - `id` string
  - `product_id` string
  - `customer` string
  - `pac_mandate_id` string
  - `is_recurring` boolean
  - `amount` integer
  - `due_day` integer
  - `metadata` object
    - `var1` string
    - `var2` string

## Other responses

- `201` — 201
- `401` — 401
- `404` — 404
- `409` — 409
- `422` — 422

---

[API](https://skmtc.net/trytoku/apis/toku-api.md) · [All operations](https://skmtc.net/trytoku/apis/toku-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trytoku/toku-api/versions/30699b13e0d0/schema)