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

# Create Series

Creates a series in the organization. A new series is not the default of any CFDI type until you set it with [Set default series](https://docs.timbrix.mx/api-reference/series/set-default.md).

## Authentication

This endpoint requires authentication with a **user session** (Bearer token). API keys are not accepted on series routes, like the other organization management routes.

* **Authorization**: `Bearer <token>`

## Path Parameters

| Parameter | Type | Required | Description |
| - | - | - | - |
| `organizationId` | string (UUID) | Yes | Organization ID |

## Request Body

| Field | Type | Required | Description |
| - | - | - | - |
| `series` | string | Yes | Series name, 1 to 25 characters, without the `\|` character. Saved in uppercase |
| `nextFolio` | integer | No | First folio the series will assign in **production**. Minimum 1, default 1 |
| `nextFolioTest` | integer | No | First folio the series will assign in **sandbox**. Minimum 1, default 1 |

Use `nextFolio` when you are moving from another invoicing system and want to continue your numbering (for example, `nextFolio: 1501` if your last invoice was number 1500).

## Permissions

Only **OWNERS** and **ADMINS** can create series. Writes on a closed organization return `403 ORGANIZATION_CLOSED`.

## Example Request

```bash theme={null}
curl -X POST https://api.timbrix.mx/organizations/550e8400-e29b-41d4-a716-446655440000/series \
  -H "Authorization: Bearer <your_token>" \
  -H "Content-Type: application/json" \
  -d '{
    "series": "FAC",
    "nextFolio": 1501
  }'
```

```typescript theme={null}
import { Timbrix } from "@timbrix/sdk"

const client = new Timbrix({ bearerToken: "<your_token>" })

const series = await client.series.create(
  "550e8400-e29b-41d4-a716-446655440000",
  { series: "FAC", nextFolio: 1501 }
)
console.log(series)
```

## Example Response

```json theme={null}
{
  "series": "FAC",
  "nextFolio": 1501,
  "nextFolioTest": 1,
  "defaultFor": []
}
```

## Common Errors

### 400 Bad Request

Invalid series name or folio (empty name, more than 25 characters, `|`, or a folio below 1).

```json theme={null}
{
  "statusCode": 400,
  "message": ["nextFolio must not be less than 1"],
  "error": "Bad Request"
}
```

### 401 Unauthorized

Authentication required.

### 403 Forbidden

Only owners and admins can create series, or the organization is closed (`ORGANIZATION_CLOSED`).

### 409 Conflict — `SERIES_ALREADY_EXISTS`

The organization already has a series with that name.

```json theme={null}
{
  "statusCode": 409,
  "message": "La serie FAC ya existe.",
  "error": "SERIES_ALREADY_EXISTS"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.