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 firstname.lastname@example.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.
We currently send notifications for the following events related to team videos and team members.
Video notifications always include the following data:
youtube_video_id(null if the video is not hosted on YouTube)
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:
Sent when a video is added to your team, or moved to your team from another team.
old_team(if video is moved from another team)
Sent when a video is removed from your team, or moved to another team.
new_team(if video is moved to another team)
Sent when one of the multiple URLs for a video on your team is set as the primary URL.
Sent when a video on your team is moved to a different project.
Sent when a new subtitle version for a video on your team is published.
Sent when subtitles are deleted for a video on your team.
Team member notifications¶
Team member notifications always include the following data:
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:
- Sent when a user is added to your team.
- Sent when a user is removed from your team.
- 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.