HTTP Callbacks for Teams

Enterprise customers can register a URL for http callbacks so that activity on their teams will fire an HTTP POST requests to that URL.

To register your Team to receive HTTP notifications, please send your request to us at enterprise@amara.org and we will set it up for you. You can also contact us with inquiry about any custom notifications that are not listed in our general offering below.

Please indicate a URL where you’d like to get notified. Each team can have their own URL, or a common URL can be used for several teams. We recommend that the selected URL uses HTTPS protocol for safer communication.

Notification Details

We currently send notifications for the following events related to team videos and team members.

Video notifications

Video notifications always include the following data:

  • event
  • amara_video_id
  • youtube_video_id (null if the video is not hosted on YouTube)
  • team
  • project
  • primary_team (used when the same callback URL is shared between multiple teams and the event that triggered callback happened on another team).

Supported events for videos:

on_video_added

Sent when a video is added to your team, or moved to your team from another team.

Additional data: old_team (if video is moved from another team)

on_video_removed

Sent when a video is removed from your team, or moved to another team.

Additional data: new_team (if video is moved to another team)

on_video_url_made_primary

Sent when one of the multiple URLs for a video on your team is set as the primary URL.

Additional data: url

on_video_moved_project

Sent when a video on your team is moved to a different project.

Additional data: old_project

on_subtitles_published

Sent when a new subtitle version for a video on your team is published.

Additional data: language_code, amara_version

on_subtitles_deleted

Sent when subtitles are deleted for a video on your team.

Additional data: language_code

Team member notifications

Team member notifications always include the following data:

  • event
  • username
  • team
  • primary_team (used when the same callback URL is shared between multiple teams and the event that triggered callback happened on another team)

Supported events for team members:

on_user_added
Sent when a user is added to your team.
on_user_removed
Sent when a user is removed from your team.
on_user_info_updated
Sent when the information in a team member’s profile is changed.

For each event we can customize the data that is sent with the notification.

Also, all notifications are numbered. You can use the number field in the notification to keep track of the events in your team(s).

To view previously sent notifications use the Team Notifications API.