Create
cancel
Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Next challenges

Recent achievements

  • Global
  • Personal

Recognition

  • Give kudos
  • Received
  • Given

Leaderboard

  • Global

Trophy case

Kudos (beta program)

Kudos logo

You've been invited into the Kudos (beta program) private group. Chat with others in the program, or give feedback to Atlassian.

View group

It's not the same without you

Join the community to find out what other Atlassian users are discussing, debating and creating.

Atlassian Community Hero Image Collage

Component subscriptions

Hi 

We want to subscribe distribution groups to components. How do we go about this? Can we do this from the back end or do we need to go to the actual statuspage and click the "Subscribe" button next to the component and enter the email address?

Thanks

Asher

2 answers

1 accepted

0 votes
Answer accepted
Dave Parrish Atlassian Team Oct 28, 2020

Hi @Asher Francis , it's Dave from Statuspage. The reason you don't see the API endpoint that Carmen refers to is that it was deprecated recently (see our post about abuse mitigation for details).

Instead, you should use our authenticated API, which provides an endpoint for create subscribers. Here are the docs for that endpoint:

https://developer.statuspage.io/#operation/postPagesPageIdSubscribers

So you'd be doing a POST to this URL:

https://api.statuspage.io/v1/pages/PAGE_ID/subscribers

(Be sure to replace the PAGE_ID with the alphanumeric ID for your page.)

You can specify a list of components to subscribe in the body of the request. Here's an example body:

{
"subscriber": {
"email": "dave@example.com",
"component_ids": [ "COMPONENT_ID_1", "COMPONENT_ID_1" ]
}
}

The COMPONENT_ID values should of course be replaced by the alphanumeric IDs for the components in question.

If you want to update the list of subscribed components for an existing subscriber, you can do a PATCH for that specific subscriber, as described here:

https://developer.statuspage.io/#operation/patchPagesPageIdSubscribersSubscriberId

Hope this helps!

Thanks Dave! This worked a treat 

Hi Asher,

You can do this with the API.

There is a conversation in the community regarding this question

https://community.atlassian.com/t5/Statuspage-questions/Update-a-subscriber-s-component-with-API/qaq-p/1009708

Hi Carmen

Thanks for this and for your answer on my other question

Unfortunately the suggestion in this article doesn't work - going to /api on my statuspage, there is no option for subscribers

Ideally, we'd like to silently subscribe distribution groups to components

Can you provide any more information on this?

We're also on the business subscription

Thanks

Asher

Hi again,

It worked for us. We use this for each subscriber:

PATCH https://api.statuspage.io/v1/{page_id}/subscribers/{subscriber_id}

and send to the page the jason file with the list of components for this subscriber

Hi Carmen

Thanks for this.

This assumes that users are already subscribed. How would we add subscribers from the API?

Thanks

Hi Asher,

We have automated the creation of a subscriber list (a csv file) from our active directory.

With one of the API we download our page's subscribers and put them in a second list.

We compare the 2 lists and if there is an email from our active directory csv file that is missing from the  pages's subscribers list, we subscribe those.

It allows us to automate the subscription of any new employe

Suggest an answer

Log in or Sign up to answer
DEPLOYMENT TYPE
CLOUD
PERMISSIONS LEVEL
Site Admin
TAGS
Community showcase
Published in Statuspage

New feature: Slack notifications for Statuspage

We're excited to announce the release of a long-requested feature on Statuspage. Now visitors to your status page can subscribe to get notified in Slack when you report an incident or maintenance. Th...

902 views 0 12
Read article

Community Events

Connect with like-minded Atlassian users at free events near you!

Find an event

Connect with like-minded Atlassian users at free events near you!

Unfortunately there are no Community Events near you at the moment.

Host an event

You're one step closer to meeting fellow Atlassian users at your local event. Learn more about Community Events

Events near you