--- title: Trigger a share creation --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Resource Sharing](https://developers.cloudflare.com/api/python/resources/resource_sharing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Trigger a share creation resource\_sharing.create(ResourceSharingCreateParams\*\*kwargs) -> [ResourceSharingCreateResponse]() POST/accounts/{account\_id}/shares Creates a new resource share for sharing Cloudflare resources with other accounts or organizations. ##### Security 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 Account identifier. maxLength32 [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) name: str The name of the share. [Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20name%20%3E%20(schema)>)

recipients: Iterable\[Recipient]

Deprecatedaccount\_id: Optional\[str] This field has been renamed to recipient_account_id. Both names are accepted during the deprecation period. Deprecated alias for recipient_account_id. Use recipient_account_id instead. The body field collided with the URL path parameter of the same name, which prevented SDK generators from distinguishing the source account (in the URL) from the recipient account (in the body). Both names will continue to be accepted until 2027-05-26 (see x-sunset). maxLength32 Link to this property organization\_id: Optional\[str] Organization identifier. maxLength32 Link to this property recipient\_account\_id: Optional\[str] The account that will receive the share. maxLength32 Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20recipients%20%3E%20(schema)>)

resources: Iterable\[Resource]

meta: object Resource Metadata. Link to this property resource\_account\_id: str Account identifier. maxLength32 Link to this property resource\_id: str Share Resource identifier. maxLength32 Link to this property

resource\_type: Literal\["custom-ruleset", "gateway-policy", "gateway-destination-ip", 4 more] Resource Type.

One of the following: "custom-ruleset" Link to this property "gateway-policy" Link to this property "gateway-destination-ip" Link to this property "gateway-block-page-settings" Link to this property "gateway-extended-email-matching" Link to this property "idp-federation-grant" Link to this property "trust-grant" Link to this property

Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(method)%20create%20%3E%20(params)%20default%20%3E%20(param)%20resources%20%3E%20(schema)>) ##### ReturnsExpand Collapse

class ResourceSharingCreateResponse: …

id: str Share identifier tag. maxLength32 Link to this property account\_id: str Account identifier. maxLength32 Link to this property account\_name: str The display name of an account. Link to this property created: datetime When the share was created. formatdate-time Link to this property modified: datetime When the share was modified. formatdate-time Link to this property name: str The name of the share. Link to this property organization\_id: str Organization identifier. maxLength32 Link to this property

status: Literal\["active", "deleting", "deleted"]

One of the following: "active" Link to this property "deleting" Link to this property "deleted" Link to this property

Link to this property

target\_type: Literal\["account", "organization"]

One of the following: "account" Link to this property "organization" Link to this property

Link to this property associated\_recipient\_count: Optional\[int] The number of recipients in the ‘associated’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property associating\_recipient\_count: Optional\[int] The number of recipients in the ‘associating’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property disassociated\_recipient\_count: Optional\[int] The number of recipients in the ‘disassociated’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property disassociating\_recipient\_count: Optional\[int] The number of recipients in the ‘disassociating’ state. This field is only included when requested via the ‘include\_recipient\_counts’ parameter. Link to this property

kind: Optional\[Literal\["sent", "received"]]

One of the following: "sent" Link to this property "received" Link to this property

Link to this property

resources: Optional\[List\[Resource]] A list of resources that are part of the share. This field is only included when requested via the ‘include\_resources’ parameter.

id: str Share Resource identifier. maxLength32 Link to this property created: datetime When the share was created. formatdate-time Link to this property meta: object Resource Metadata. Link to this property modified: datetime When the share was modified. formatdate-time Link to this property resource\_account\_id: str Account identifier. maxLength32 Link to this property resource\_id: str Share Resource identifier. maxLength32 Link to this property

resource\_type: Literal\["custom-ruleset", "gateway-policy", "gateway-destination-ip", 4 more] Resource Type.

Link to this property resource\_version: int Resource Version. Link to this property

status: Literal\["active", "deleting", "deleted"] Resource Status.

One of the following: "active" Link to this property "deleting" Link to this property "deleted" Link to this property

Link to this property

[Link to this property](<#(resource)%20resource_sharing%20%3E%20(model)%20resource_sharing_create_response%20%3E%20(schema)>) ### Trigger a share creation Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_email=os.environ.get("CLOUDFLARE_EMAIL"), # This is the default and can be omitted api_key=os.environ.get("CLOUDFLARE_API_KEY"), # This is the default and can be omitted ) resource_sharing = client.resource_sharing.create( account_id="023e105f4ecef8ad9ca31a8372d0c353", name="My Shared WAF Managed Rule", recipients=[{}], resources=[{ "meta": {}, "resource_account_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_type": "custom-ruleset", }], ) print(resource_sharing.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "3fd85f74b32742f1bff64a85009dda07", "account_id": "023e105f4ecef8ad9ca31a8372d0c353", "account_name": "Account A", "created": "2023-09-21T18:56:32.624632Z", "modified": "2023-09-21T18:56:32.624632Z", "name": "My Shared WAF Managed Rule", "organization_id": "023e105f4ecef8ad9ca31a8372d0c353", "status": "active", "target_type": "account", "associated_recipient_count": 10, "associating_recipient_count": 1, "disassociated_recipient_count": 0, "disassociating_recipient_count": 0, "kind": "sent", "resources": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "created": "2023-09-21T18:56:32.624632Z", "meta": {}, "modified": "2023-09-21T18:56:32.624632Z", "resource_account_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_type": "custom-ruleset", "resource_version": 0, "status": "active" } ] } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "success": true, "result": { "id": "3fd85f74b32742f1bff64a85009dda07", "account_id": "023e105f4ecef8ad9ca31a8372d0c353", "account_name": "Account A", "created": "2023-09-21T18:56:32.624632Z", "modified": "2023-09-21T18:56:32.624632Z", "name": "My Shared WAF Managed Rule", "organization_id": "023e105f4ecef8ad9ca31a8372d0c353", "status": "active", "target_type": "account", "associated_recipient_count": 10, "associating_recipient_count": 1, "disassociated_recipient_count": 0, "disassociating_recipient_count": 0, "kind": "sent", "resources": [ { "id": "023e105f4ecef8ad9ca31a8372d0c353", "created": "2023-09-21T18:56:32.624632Z", "meta": {}, "modified": "2023-09-21T18:56:32.624632Z", "resource_account_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_id": "023e105f4ecef8ad9ca31a8372d0c353", "resource_type": "custom-ruleset", "resource_version": 0, "status": "active" } ] } } ```