event Bridge Webhook Subscription Updatemutation
Updates an Amazon EventBridge webhook subscription.
Building an app? If you only use app-specific webhooks, you won't need this. App-specific webhook subscriptions specified in your shopify.app.toml
may be easier. They are automatically kept up to date by Shopify & require less maintenance. Please read About managing webhook subscriptions.
Arguments
The ID of the webhook subscription to update.
Specifies the input fields for an EventBridge webhook subscription.
EventBridgeWebhookSubscriptionUpdatePayload returns
The list of errors that occurred from executing the mutation.
The webhook subscription that was updated.
Code examples for MUTATION: eventBridgeWebhookSubscriptionUpdate
Query Reference for MUTATION: eventBridgeWebhookSubscriptionUpdate
"mutation eventBridgeWebhookSubscriptionUpdate($id: ID!, $webhookSubscription: EventBridgeWebhookSubscriptionInput!) {\n eventBridgeWebhookSubscriptionUpdate(id: $id, webhookSubscription: $webhookSubscription) {\n userErrors {\n field\n message\n }\n webhookSubscription {\n # WebhookSubscription fields\n }\n }\n}"
Input Reference for MUTATION: eventBridgeWebhookSubscriptionUpdate
"{\n \"id\": \"gid://shopify/<objectName>/10079785100\",\n \"webhookSubscription\": {\n \"arn\": \"\",\n \"filter\": \"<your-filter>\",\n \"format\": \"JSON\",\n \"includeFields\": [\n \"<your-includeFields>\"\n ],\n \"metafieldNamespaces\": [\n \"<your-metafieldNamespaces>\"\n ]\n }\n}"
Schema Reference for MUTATION: eventBridgeWebhookSubscriptionUpdate
"input EventBridgeWebhookSubscriptionInput {\n arn: ARN\n filter: String\n format: WebhookSubscriptionFormat\n includeFields: [String!]\n metafieldNamespaces: [String!]\n}\n"
Display Examples for MUTATION: eventBridgeWebhookSubscriptionUpdate
[ { "example": { "type_name": "eventbridgewebhooksubscriptionupdate", "title": "Update a webhook subscription from HTTP to Amazon EventBridge", "query_string": "mutation eventBridgeWebhookSubscriptionUpdate($id: ID!, $webhookSubscription: EventBridgeWebhookSubscriptionInput!) {\n eventBridgeWebhookSubscriptionUpdate(id: $id, webhookSubscription: $webhookSubscription) {\n userErrors {\n field\n message\n }\n webhookSubscription {\n id\n topic\n endpoint {\n ... on WebhookEventBridgeEndpoint {\n arn\n }\n }\n }\n }\n}", "variables": { "id": "gid://shopify/WebhookSubscription/525699895", "webhookSubscription": { "arn": "arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/755357713/test-event-source", "format": "JSON" } }, "response": { "data": { "eventBridgeWebhookSubscriptionUpdate": { "userErrors": [], "webhookSubscription": { "id": "gid://shopify/WebhookSubscription/525699895", "topic": "ORDERS_CREATE", "endpoint": { "arn": "arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/755357713/test-event-source" } } } } }, "api_name": "admin", "minimum_api_version": "2023-10", "maximum_api_version": "unstable", "location": "/components/apps/test/unit/graph_api/admin/mutations/event_bridge_webhook_subscription_update_test.rb", "curl_example": "curl -X POST \\\nhttps://your-development-store.myshopify.com/admin/api/2024-10/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Access-Token: {access_token}' \\\n-d '{\n\"query\": \"mutation eventBridgeWebhookSubscriptionUpdate($id: ID!, $webhookSubscription: EventBridgeWebhookSubscriptionInput!) { eventBridgeWebhookSubscriptionUpdate(id: $id, webhookSubscription: $webhookSubscription) { userErrors { field message } webhookSubscription { id topic endpoint { ... on WebhookEventBridgeEndpoint { arn } } } } }\",\n \"variables\": {\n \"id\": \"gid://shopify/WebhookSubscription/525699895\",\n \"webhookSubscription\": {\n \"arn\": \"arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/755357713/test-event-source\",\n \"format\": \"JSON\"\n }\n }\n}'\n", "remix_example": "const { admin } = await authenticate.admin(request);\n\nconst response = await admin.graphql(\n `#graphql\n mutation eventBridgeWebhookSubscriptionUpdate($id: ID!, $webhookSubscription: EventBridgeWebhookSubscriptionInput!) {\n eventBridgeWebhookSubscriptionUpdate(id: $id, webhookSubscription: $webhookSubscription) {\n userErrors {\n field\n message\n }\n webhookSubscription {\n id\n topic\n endpoint {\n ... on WebhookEventBridgeEndpoint {\n arn\n }\n }\n }\n }\n }`,\n {\n variables: {\n \"id\": \"gid://shopify/WebhookSubscription/525699895\",\n \"webhookSubscription\": {\n \"arn\": \"arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/755357713/test-event-source\",\n \"format\": \"JSON\"\n }\n },\n },\n);\n\nconst data = await response.json();\n", "ruby_example": "session = ShopifyAPI::Auth::Session.new(\n shop: \"your-development-store.myshopify.com\",\n access_token: access_token\n)\nclient = ShopifyAPI::Clients::Graphql::Admin.new(\n session: session\n)\n\nquery = <<~QUERY\n mutation eventBridgeWebhookSubscriptionUpdate($id: ID!, $webhookSubscription: EventBridgeWebhookSubscriptionInput!) {\n eventBridgeWebhookSubscriptionUpdate(id: $id, webhookSubscription: $webhookSubscription) {\n userErrors {\n field\n message\n }\n webhookSubscription {\n id\n topic\n endpoint {\n ... on WebhookEventBridgeEndpoint {\n arn\n }\n }\n }\n }\n }\nQUERY\n\nvariables = {\n \"id\": \"gid://shopify/WebhookSubscription/525699895\",\n \"webhookSubscription\": {\n \"arn\": \"arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/755357713/test-event-source\",\n \"format\": \"JSON\"\n }\n}\n\nresponse = client.query(query: query, variables: variables)\n", "node_example": "const client = new shopify.clients.Graphql({session});\nconst data = await client.query({\n data: {\n \"query\": `mutation eventBridgeWebhookSubscriptionUpdate($id: ID!, $webhookSubscription: EventBridgeWebhookSubscriptionInput!) {\n eventBridgeWebhookSubscriptionUpdate(id: $id, webhookSubscription: $webhookSubscription) {\n userErrors {\n field\n message\n }\n webhookSubscription {\n id\n topic\n endpoint {\n ... on WebhookEventBridgeEndpoint {\n arn\n }\n }\n }\n }\n }`,\n \"variables\": {\n \"id\": \"gid://shopify/WebhookSubscription/525699895\",\n \"webhookSubscription\": {\n \"arn\": \"arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/755357713/test-event-source\",\n \"format\": \"JSON\"\n }\n },\n },\n});\n", "php_example": "use Shopify\\Clients\\Graphql;\n\n$client = new Graphql(\"your-development-store.myshopify.com\", $accessToken);\n$query = <<<QUERY\n mutation eventBridgeWebhookSubscriptionUpdate($id: ID!, $webhookSubscription: EventBridgeWebhookSubscriptionInput!) {\n eventBridgeWebhookSubscriptionUpdate(id: $id, webhookSubscription: $webhookSubscription) {\n userErrors {\n field\n message\n }\n webhookSubscription {\n id\n topic\n endpoint {\n ... on WebhookEventBridgeEndpoint {\n arn\n }\n }\n }\n }\n }\nQUERY;\n\n$variables = [\n \"id\" => \"gid://shopify/WebhookSubscription/525699895\",\n \"webhookSubscription\" => [\n \"arn\" => \"arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/755357713/test-event-source\",\n \"format\" => \"JSON\",\n ],\n];\n\n$response = $client->query([\"query\" => $query, \"variables\" => $variables]);\n" }, "titleStringKey": "variables", "inputVariableEntries": [ { "arg": { "name": "id", "description": "The ID of the webhook subscription to update.", "type": { "kind": "SCALAR", "name": "ID", "list": false, "non_null": true }, "defaultValue": null, "typeSignature": "ID!", "isDeprecated": false, "deprecationReason": null, "kind": "ARGUMENT" }, "key": "id", "argValue": " \"gid://shopify/WebhookSubscription/525699895\"", "typeKind": "MUTATION" }, { "arg": { "name": "webhookSubscription", "description": "Specifies the input fields for an EventBridge webhook subscription.", "type": { "kind": "INPUT_OBJECT", "name": "EventBridgeWebhookSubscriptionInput", "list": false, "non_null": true }, "defaultValue": null, "typeSignature": "EventBridgeWebhookSubscriptionInput!", "isDeprecated": false, "deprecationReason": null, "kind": "ARGUMENT" }, "key": "webhookSubscription", "argValue": " {\"arn\":\"arn:aws:events:us-east-1::event-source/aws.partner/shopify.com/755357713/test-event-source\",\"format\":\"JSON\"}", "typeKind": "MUTATION" } ] } ]