Content Hub

Webhooks

Important

Content Hub 2.x will reach end-of-life on December 31, 2024. Acquia recommends that you update your Content Hub version to Content Hub 3.x by using the composer require instructions available on the acquia_contenthub project page.

Content Hub uses webhooks to communicate with the service, enabling your publisher and subscriber websites to communicate through the service as an intermediary. A webhook is an endpoint that the service knows about.

On a publisher or subscriber website, clicking the Update Public URL button in the interface creates a webhook. That registers your website, using the following format as the endpoint:

yourdomain.com/acquia-contenthub/webhook

A webhook defines the messaging endpoint. When information from the service sends to publishers or subscribers, the data sends as a POST request to the HMAC-authenticated endpoint. The Drupal module listens for those requests and performs actions based on the information in the request. Requests requiring actions may include entity creation (a new entity requires import), entity updates (content changes), or other changes.

Content Hub 2.x requires registering a valid webhook. If there is no registered webhook, some features do not work. Users may also see errors. Webhook registration failures often occur when the registering website is not publicly accessible, such as local development environments.

Changing webhooks

Users can change the webhook URL using the configuration form in the module. This may be necessary if you are working with Content Hub locally and need the public-accessible URL to be an ngrok tunnel.

Editing or deleting webhooks requires the Content Hub Publisher module.

  1. Sign in to your Content Hub publisher website as an administrator.
  2. Navigate to Configuration > Acquia Content Hub > Subscription Manager.
  3. Under Administer webhooks:
    • Edit the URL field of an existing webhook
    • Use Add a new Webhook to add a new webhook
    • Remove the URL to delete a webhook
  4. Click Save configuration.

Note

If your website does not have a valid SSL certificate, you must configure your webhooks using HTTP, not HTTPS.

They can also be updated through the Content Hub API, using a CRUD (create-read-update-delete) operation.

Updated webhooks register if the URL responds with a valid HMAC-authenticated response. You cannot register unauthenticated URLs such as example.com/acquia-contenthub/webhook.

Troubleshooting webhooks

If Content Hub cannot send webhooks to a subscribing website, it also cannot notify the subscribing website of a problem with the webhook. If a webhook fails or is unreachable for 72 hours, Content Hub suppresses the webhook for 12 hours. During the 12-hour window, the webhook does not receive any updates until it is manually enabled within the window or is unsuppressed after 12 hours.

After Content Hub suppresses a webhook, you can enable it again using one of the following methods:

  • Wait 12 hours for Content Hub to re-enable the webhook.
  • Use the webhook enable API endpoint to manually enable the webhook within the 12-hour window.
  • (For backwards compatibility only) Send a POST request to the v2/settings/webhooks endpoint.

Note

Content Hub deletes ngrok.io development webhook endpoints unreachable for more than 72 hours.

To review the history logs for Content Hub, use the /v2/history endpoint. For more information, see Using the Content Hub API.

Did not find what you were looking for?

If this content did not answer your questions, try searching or contacting our support team for further assistance.

Acquia Help

Filter by product:

Content Hub common questions