Skip to main content
This is a staging build of the docs

2025-01-10: Deprecation extension for webhook changes

· 3 min read
David Coplowe
Product Owner, Client Experience

We have extended the deprecation window for our previously announced webhook changes.

On April 10, 2024 we announced three deprecations following the release of our new webhooks service:

To ensure a smooth transition, we are extending the deprecation period to January 10, 2025.

Codat's webhook service

Not using the new service yet? See how you can migrate in our migration guide.

Action required

Clients using the legacy webhook service must migrate to our new service and address the following deprecations.

Deprecation of /rules/alerts endpoints

The following endpoints will be deprecated:

  • GET /rules/alerts
  • GET /rules/{ruleId}/alerts
  • GET /rules/alerts/{alertId}

Action required

Review and update your application logic to remove any dependencies on the deprecated endpoints. This will help prevent any disruptions to your integration with Codat.

Expected impact

If no action is taken by January 10, 2025, your application will fail when retrieving rules alerts programmatically. The deprecated endpoints will return Not found (404) status codes, preventing your application from functioning normally.


Deprecation of RuleId in rules webhooks

The RuleId property will be deprecated in the following webhook rule schemas:

Action required

Review and update your application logic to remove any dependencies on the RuleId. This will help prevent any disruptions to your integration with Codat.

You should use RuleType to identify what event a given webhook corresponds with.

Expected impact

If no action is taken by January 10, 2025, your application will continue to receive events, but the RuleId will not be populated.

Any application logic using the RuleId property will function following your unhappy path for RuleId logic. Depending on your implementation, this may impact your processing Codat's webhooks.


Deprecation of rule-based email notifications

Email notifications are currently managed by our webhook rules service. After the deprecation date, this service will no longer exist. Instead, you can use our Zapier integration to trigger automated workflows that send an email notification or a Slack message.

Action required

To continue receiving email notifications, use our Zapier integration to create a workflow using the 'Email by Zapier' action.

Expected impact

If no action is taken by January 10, 2025, you will stop receiving email notifications created using our Receive webhooks events via email feature.