---
title: Line Provisioning | Sendblue Docs
description: Request new phone lines for your Sendblue account
---

Request new phone lines for your Sendblue account. Line requests are processed by our team and fulfilled based on availability.

---

## Request a New Line

Submit a request for a new phone number.

```
POST /accounts/lines/add-line
```

### Request Body

| Parameter           | Type   | Required | Description                           |
| ------------------- | ------ | -------- | ------------------------------------- |
| `line_request_type` | string | Yes      | Type of line: `phone`                 |
| `desired_area_code` | string | No       | 3-digit area code or 5-digit zip code |

### Example Request

Terminal window

```
curl -X POST "https://api.sendblue.co/accounts/lines/add-line" \
  -H "sb-api-key-id: YOUR_API_KEY" \
  -H "sb-api-secret-key: YOUR_API_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "line_request_type": "phone",
    "desired_area_code": "415"
  }'
```

### Success Response (200)

```
{
  "status": "OK",
  "data": {
    "id": 12345,
    "type": "PHONE",
    "status": "OPEN",
    "desiredAreaCode": "415",
    "createdAt": "2025-01-30T10:00:00.000Z"
  }
}
```

### Response Schema

| Field             | Type           | Description                                      |
| ----------------- | -------------- | ------------------------------------------------ |
| `id`              | number         | Unique ticket ID for tracking                    |
| `type`            | string         | `PHONE`                                          |
| `status`          | string         | Request status: `OPEN`, `FULFILLED`, `CANCELLED` |
| `desiredAreaCode` | string \| null | Requested area code                              |
| `createdAt`       | string         | ISO 8601 timestamp                               |

---

## Check Request Status

Get the status of a line request ticket.

```
GET /accounts/lines/line-request/:lineRequestTicketId
```

### Path Parameters

| Parameter             | Type   | Description                              |
| --------------------- | ------ | ---------------------------------------- |
| `lineRequestTicketId` | number | The ticket ID from the add-line response |

### Example Request

Terminal window

```
curl -X GET "https://api.sendblue.co/accounts/lines/line-request/12345" \
  -H "sb-api-key-id: YOUR_API_KEY" \
  -H "sb-api-secret-key: YOUR_API_SECRET"
```

### Success Response (200)

```
{
  "status": "OK",
  "data": {
    "id": 12345,
    "type": "PHONE",
    "status": "FULFILLED",
    "desiredAreaCode": "415",
    "fulfilledNumber": "+14155551234",
    "createdAt": "2025-01-30T10:00:00.000Z",
    "fulfilledAt": "2025-01-30T12:00:00.000Z"
  }
}
```

---

## Error Responses

| HTTP Status | Description                       |
| ----------- | --------------------------------- |
| 400         | Missing or invalid parameters     |
| 401         | Invalid API credentials           |
| 403         | Ticket belongs to another account |
| 404         | Line request ticket not found     |

```
{
  "status": "ERROR",
  "message": "Description of what went wrong"
}
```

---

## Notes

- Line requests are reviewed and fulfilled by our team
- Area code availability varies by region
- Contact <support@sendblue.com> for expedited provisioning or specific requirements
- **Line health notifications** are available for Enterprise plan customers. Contact your account manager to enable this feature.