--- title: Trigger a share creation --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Resource Sharing](https://developers.cloudflare.com/api/go/resources/resource_sharing) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Trigger a share creation client.ResourceSharing.New(ctx, params) (\*[ResourceSharingNewResponse](), error) 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
params ResourceSharingNewParams AccountID param.Field\[string] Path param: Account identifier. maxLength32 Link to this property Name param.Field\[string] Body param: The name of the share. Link to this property
Recipients param.Field\[\[]ResourceSharingNewParamsRecipient] Body param DeprecatedAccountID stringOptional 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 OrganizationID stringOptional Organization identifier. maxLength32 Link to this property RecipientAccountID stringOptional The account that will receive the share. maxLength32 Link to this property
Link to this property
Resources param.Field\[\[]ResourceSharingNewParamsResource] Body param Meta unknown Resource Metadata. Link to this property ResourceAccountID string Account identifier. maxLength32 Link to this property ResourceID string Share Resource identifier. maxLength32 Link to this property
ResourceType ResourceSharingNewParamsResourcesResourceType Resource Type. One of the following: const ResourceSharingNewParamsResourcesResourceTypeCustomRuleset ResourceSharingNewParamsResourcesResourceType = "custom-ruleset" Link to this property const ResourceSharingNewParamsResourcesResourceTypeGatewayPolicy ResourceSharingNewParamsResourcesResourceType = "gateway-policy" Link to this property const ResourceSharingNewParamsResourcesResourceTypeGatewayDestinationIP ResourceSharingNewParamsResourcesResourceType = "gateway-destination-ip" Link to this property const ResourceSharingNewParamsResourcesResourceTypeGatewayBlockPageSettings ResourceSharingNewParamsResourcesResourceType = "gateway-block-page-settings" Link to this property const ResourceSharingNewParamsResourcesResourceTypeGatewayExtendedEmailMatching ResourceSharingNewParamsResourcesResourceType = "gateway-extended-email-matching" Link to this property const ResourceSharingNewParamsResourcesResourceTypeIdPFederationGrant ResourceSharingNewParamsResourcesResourceType = "idp-federation-grant" Link to this property const ResourceSharingNewParamsResourcesResourceTypeTrustGrant ResourceSharingNewParamsResourcesResourceType = "trust-grant" Link to this property
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>) ##### ReturnsExpand Collapse
type ResourceSharingNewResponse struct{…} ID string Share identifier tag. maxLength32 Link to this property AccountID string Account identifier. maxLength32 Link to this property AccountName string The display name of an account. Link to this property Created Time When the share was created. formatdate-time Link to this property Modified Time When the share was modified. formatdate-time Link to this property Name string The name of the share. Link to this property OrganizationID string Organization identifier. maxLength32 Link to this property
Status ResourceSharingNewResponseStatus One of the following: const ResourceSharingNewResponseStatusActive ResourceSharingNewResponseStatus = "active" Link to this property const ResourceSharingNewResponseStatusDeleting ResourceSharingNewResponseStatus = "deleting" Link to this property const ResourceSharingNewResponseStatusDeleted ResourceSharingNewResponseStatus = "deleted" Link to this property
Link to this property
TargetType ResourceSharingNewResponseTargetType One of the following: const ResourceSharingNewResponseTargetTypeAccount ResourceSharingNewResponseTargetType = "account" Link to this property const ResourceSharingNewResponseTargetTypeOrganization ResourceSharingNewResponseTargetType = "organization" Link to this property
Link to this property AssociatedRecipientCount int64Optional 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 AssociatingRecipientCount int64Optional 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 DisassociatedRecipientCount int64Optional 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 DisassociatingRecipientCount int64Optional 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 ResourceSharingNewResponseKindOptional One of the following: const ResourceSharingNewResponseKindSent ResourceSharingNewResponseKind = "sent" Link to this property const ResourceSharingNewResponseKindReceived ResourceSharingNewResponseKind = "received" Link to this property
Link to this property
Resources \[]ResourceSharingNewResponseResourceOptional A list of resources that are part of the share. This field is only included when requested via the ‘include\_resources’ parameter. ID string Share Resource identifier. maxLength32 Link to this property Created Time When the share was created. formatdate-time Link to this property Meta unknown Resource Metadata. Link to this property Modified Time When the share was modified. formatdate-time Link to this property ResourceAccountID string Account identifier. maxLength32 Link to this property ResourceID string Share Resource identifier. maxLength32 Link to this property
ResourceType ResourceSharingNewResponseResourcesResourceType Resource Type. One of the following: const ResourceSharingNewResponseResourcesResourceTypeCustomRuleset ResourceSharingNewResponseResourcesResourceType = "custom-ruleset" Link to this property const ResourceSharingNewResponseResourcesResourceTypeGatewayPolicy ResourceSharingNewResponseResourcesResourceType = "gateway-policy" Link to this property const ResourceSharingNewResponseResourcesResourceTypeGatewayDestinationIP ResourceSharingNewResponseResourcesResourceType = "gateway-destination-ip" Link to this property const ResourceSharingNewResponseResourcesResourceTypeGatewayBlockPageSettings ResourceSharingNewResponseResourcesResourceType = "gateway-block-page-settings" Link to this property const ResourceSharingNewResponseResourcesResourceTypeGatewayExtendedEmailMatching ResourceSharingNewResponseResourcesResourceType = "gateway-extended-email-matching" Link to this property const ResourceSharingNewResponseResourcesResourceTypeIdPFederationGrant ResourceSharingNewResponseResourcesResourceType = "idp-federation-grant" Link to this property const ResourceSharingNewResponseResourcesResourceTypeTrustGrant ResourceSharingNewResponseResourcesResourceType = "trust-grant" Link to this property
Link to this property ResourceVersion int64 Resource Version. Link to this property
Status ResourceSharingNewResponseResourcesStatus Resource Status. One of the following: const ResourceSharingNewResponseResourcesStatusActive ResourceSharingNewResponseResourcesStatus = "active" Link to this property const ResourceSharingNewResponseResourcesStatusDeleting ResourceSharingNewResponseResourcesStatus = "deleting" Link to this property const ResourceSharingNewResponseResourcesStatusDeleted ResourceSharingNewResponseResourcesStatus = "deleted" Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20resource_sharing%20%3E%20(model)%20ResourceSharingNewResponse%20%3E%20(schema)>) ### Trigger a share creation Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/resource_sharing" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) resourceSharing, err := client.ResourceSharing.New(context.TODO(), resource_sharing.ResourceSharingNewParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Name: cloudflare.F("My Shared WAF Managed Rule"), Recipients: cloudflare.F([]resource_sharing.ResourceSharingNewParamsRecipient{resource_sharing.ResourceSharingNewParamsRecipient{ }}), Resources: cloudflare.F([]resource_sharing.ResourceSharingNewParamsResource{resource_sharing.ResourceSharingNewParamsResource{ Meta: cloudflare.F[any](map[string]interface{}{ }), ResourceAccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), ResourceID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), ResourceType: cloudflare.F(resource_sharing.ResourceSharingNewParamsResourcesResourceTypeCustomRuleset), }}), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", resourceSharing.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" } ] } } ```