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:

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)

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)

video-made-primary

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

Additional data: url

video-moved-project

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

Additional data: old_project

subtitles-published

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

Additional data: language_code, amara_version

subtitle-unpublished

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:

member-added
Sent when a user is added to your team.
member-removed
Sent when a user is removed from your team.
member-profile-changed
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.