Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Hooks are setup in a way that will not delay or impact users updating information, etc. Generally hooks are sent information immediately when records are altered, however there may be instances where it will take several seconds or more before a hook is triggered based on system load and other demands.

Note that given records can be updated across a number of ways, there may be instances where a hook is triggered when related information is updated – such as a change to users preferences might trigger a hook to be sent, or changes to someones permissions might trigger hooks to be sent for group memberships. For this reason the systems which process this information should setup in a way that they will take this into account.

Troubleshooting

You will need to ensure the URL or SNS topic has been setup correctly by testing messages are sent to it properly - generally this can be done by adding/editing/removing an entry in the appropriate section specified (eg. editing a person in the system if a hook handles people).

...

Webhooks are triggered regardless of particular permissions users might have. They are only able to be setup by users whom have system-level administrator access - that is, have administrator access to the top-level groups setup on the system.

Contents

Web hooks are sent in JSON format, and generally contain the following;

  • Timestamp the change was made (UTC timezone)
  • A list of fields which were updated
  • The modified content
  • A copy of the current record (eg. a persons details)