v1

latestOpenAPI 3.1.0Copyright Pismo2026-07-247702,7523.1 MB
Phones

Create phone

Create a new phone number for the specified account.

This event generates a Phone created event.

post/accounts/v1/accounts/{accountId}/phones

Path parameters

accountIdinteger required
Example:6912345

Account ID

Headers

x-customer-idnumber required

Pismo customer ID. Must be associated with account whose ID is embedded in the access token.

Request body

numberstring required

Phone number

type'RESIDENTIAL' | 'COMMERCIAL' | 'MOBILE' required

Phone number type

activeboolean

Is phone active? Default is true.

area_codeinteger

Phone number area code

country_codestring

Phone number's country code

extensionstring

Optional phone number extension

Example request

{
  "number": "11912345678",
  "type": "MOBILE",
  "area_code": 11,
  "country_code": "555",
  "extension": "ext. 9"
}

Response

The phone was successfully created

idinteger required

Phone ID

Example response

{
  "id": 8714
}