Represents a phone number.PhoneNumberresources enable phone calls to be answered by Dialogflow services and are added to a project through aPhoneNumberOrder.
Optional. The unique identifier of this phone number. Required forPhoneNumbers.UpdatePhoneNumbermethod. Format:projects/<Project ID>/phoneNumbers/<PhoneNumber ID>. Format:projects/<Project ID>/locations/<Location
ID>/phoneNumbers/<PhoneNumber ID>.
phoneNumber
string
Output only. Phone number inE.164format. An example of a correctly formatted phone number: +15556767888.
conversationProfile
string
Optional. The conversation profile calls to thisPhoneNumbershould use. The project ID here should be the same as the one inname. Format:projects/<Project ID>/conversationProfiles/<ConversationProfile
ID>. Format:projects/<Project ID>/locations/<Location
ID>/conversationProfiles/<ConversationProfile ID>.
Output only. The state of thePhoneNumber. Defaults toACTIVE.PhoneNumberobjects set toDELETE_REQUESTEDalways decline incoming calls and can be removed completely within 30 days.
LifecycleState
The states that aPhoneNumbercan be in.
Enums
LIFECYCLE_STATE_UNSPECIFIED
This value is never used.
ACTIVE
Number is active and can receive phone calls.
DELETE_REQUESTED
Number is pending deletion, and cannot receive calls.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-27 UTC."],[[["\u003cp\u003eThis document outlines the \u003ccode\u003ePhoneNumber\u003c/code\u003e resource, which represents a phone number that can be used to handle phone calls via Dialogflow services and are acquired through a \u003ccode\u003ePhoneNumberOrder\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eA \u003ccode\u003ePhoneNumber\u003c/code\u003e resource has attributes including a unique \u003ccode\u003ename\u003c/code\u003e, the \u003ccode\u003ephoneNumber\u003c/code\u003e itself in E.164 format, a \u003ccode\u003econversationProfile\u003c/code\u003e for call handling, and a \u003ccode\u003elifecycleState\u003c/code\u003e that determines its operational status.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003elifecycleState\u003c/code\u003e of a \u003ccode\u003ePhoneNumber\u003c/code\u003e can be either \u003ccode\u003eACTIVE\u003c/code\u003e to receive calls or \u003ccode\u003eDELETE_REQUESTED\u003c/code\u003e which denies calls and initiates a 30-day deletion period.\u003c/p\u003e\n"],["\u003cp\u003eThe methods available for managing \u003ccode\u003ePhoneNumber\u003c/code\u003e resources include functions to delete, list, update (patch), and cancel deletion requests (undelete) of \u003ccode\u003ePhoneNumber\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003ePhoneNumber\u003c/code\u003e resource is represented in JSON with keys for name, phone number, conversation profile, and the lifecycle state of the phone number.\u003c/p\u003e\n"]]],[],null,["# REST Resource: projects.phoneNumbers\n\n- [Resource: PhoneNumber](#PhoneNumber)\n - [JSON representation](#PhoneNumber.SCHEMA_REPRESENTATION)\n- [LifecycleState](#LifecycleState)\n- [Methods](#METHODS_SUMMARY)\n\nResource: PhoneNumber\n---------------------\n\nRepresents a phone number. `PhoneNumber` resources enable phone calls to be answered by Dialogflow services and are added to a project through a `PhoneNumberOrder`.\n\nLifecycleState\n--------------\n\nThe states that a `PhoneNumber` can be in."]]
