--- title: Add Prefix --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Addressing](https://developers.cloudflare.com/api/python/resources/addressing) [Prefixes](https://developers.cloudflare.com/api/python/resources/addressing/subresources/prefixes) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Add Prefix addressing.prefixes.create(PrefixCreateParams\*\*kwargs) -> [Prefix]() POST/accounts/{account\_id}/addressing/prefixes Add a new prefix under the account. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### ParametersExpand Collapse account\_id: str Identifier of a Cloudflare account. maxLength32 [Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) asn: int Autonomous System Number (ASN) the prefix will be advertised under. [Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20asn%20%3E%20(schema)>) cidr: str IP Prefix in Classless Inter-Domain Routing format. [Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20cidr%20%3E%20(schema)>) delegate\_loa\_creation: Optional\[[bool]()] Whether Cloudflare is allowed to generate the LOA document on behalf of the prefix owner. [Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20delegate_loa_creation%20%3E%20(schema)>) description: Optional\[str] Description of the prefix. maxLength1000 [Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20description%20%3E%20(schema)>) loa\_document\_id: Optional\[str] Identifier for the uploaded LOA document. maxLength32 [Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20loa_document_id%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class Prefix: … id: Optional\[str] Identifier of an IP Prefix. maxLength32 Link to this property account\_id: Optional\[str] Identifier of a Cloudflare account. maxLength32 Link to this property Deprecatedadvertised: Optional\[bool] Prefer the BGP Prefixes API instead, which allows for advertising multiple BGP routes within a single IP Prefix. Prefix advertisement status to the Internet. This field is only not ‘null’ if on demand is enabled. Link to this property Deprecatedadvertised\_modified\_at: Optional\[datetime] Prefer the BGP Prefixes API instead, which allows for advertising multiple BGP routes within a single IP Prefix. Last time the advertisement status was changed. This field is only not ‘null’ if on demand is enabled. formatdate-time Link to this property approved: Optional\[str] Approval state of the prefix (P = pending, V = active). Link to this property asn: Optional\[int] Autonomous System Number (ASN) the prefix will be advertised under. Link to this property cidr: Optional\[str] IP Prefix in Classless Inter-Domain Routing format. Link to this property created\_at: Optional\[datetime] formatdate-time Link to this property delegate\_loa\_creation: Optional\[bool] Whether Cloudflare is allowed to generate the LOA document on behalf of the prefix owner. Link to this property description: Optional\[str] Description of the prefix. maxLength1000 Link to this property irr\_validation\_state: Optional\[str] State of one kind of validation for an IP prefix. Link to this property loa\_document\_id: Optional\[str] Identifier for the uploaded LOA document. maxLength32 Link to this property modified\_at: Optional\[datetime] formatdate-time Link to this property Deprecatedon\_demand\_enabled: Optional\[bool] Prefer the BGP Prefixes API instead, which allows for advertising multiple BGP routes within a single IP Prefix. Whether advertisement of the prefix to the Internet may be dynamically enabled or disabled. Link to this property Deprecatedon\_demand\_locked: Optional\[bool] Prefer the BGP Prefixes API instead, which allows for advertising multiple BGP routes within a single IP Prefix. Whether advertisement status of the prefix is locked, meaning it cannot be changed. Link to this property ownership\_validation\_state: Optional\[str] State of one kind of validation for an IP prefix. Link to this property ownership\_validation\_token: Optional\[str] Token provided to demonstrate ownership of the prefix. Link to this property rpki\_validation\_state: Optional\[str] State of one kind of validation for an IP prefix. Link to this property
[Link to this property](<#(resource)%20addressing.prefixes%20%3E%20(model)%20prefix%20%3E%20(schema)>) ### Add Prefix Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) prefix = client.addressing.prefixes.create( account_id="258def64c72dae45f3e4c8516e2111f2", asn=13335, cidr="192.0.2.0/24", ) print(prefix.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "2af39739cc4e3b5910c918468bb89828", "account_id": "258def64c72dae45f3e4c8516e2111f2", "advertised": true, "advertised_modified_at": "2014-01-01T05:20:00.12345Z", "approved": "P", "asn": 13335, "cidr": "192.0.2.0/24", "created_at": "2014-01-01T05:20:00.12345Z", "delegate_loa_creation": true, "description": "Internal test prefix", "irr_validation_state": "pending", "loa_document_id": "d933b1530bc56c9953cf8ce166da8004", "modified_at": "2014-01-01T05:20:00.12345Z", "on_demand_enabled": true, "on_demand_locked": false, "ownership_validation_state": "pending", "ownership_validation_token": "1234a5b6-1234-1abc-12a3-1234a5b6789c", "rpki_validation_state": "pending" } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "2af39739cc4e3b5910c918468bb89828", "account_id": "258def64c72dae45f3e4c8516e2111f2", "advertised": true, "advertised_modified_at": "2014-01-01T05:20:00.12345Z", "approved": "P", "asn": 13335, "cidr": "192.0.2.0/24", "created_at": "2014-01-01T05:20:00.12345Z", "delegate_loa_creation": true, "description": "Internal test prefix", "irr_validation_state": "pending", "loa_document_id": "d933b1530bc56c9953cf8ce166da8004", "modified_at": "2014-01-01T05:20:00.12345Z", "on_demand_enabled": true, "on_demand_locked": false, "ownership_validation_state": "pending", "ownership_validation_token": "1234a5b6-1234-1abc-12a3-1234a5b6789c", "rpki_validation_state": "pending" } } ```