Line Provisioning

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 /account/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

curl -X POST "https://api.sendblue.co/account/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 /account/lines/line-request/:lineRequestTicketId

Path Parameters

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

Example Request

curl -X GET "https://api.sendblue.co/account/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 [email protected] for expedited provisioning or specific requirements