503 Error

Matt Scott
Matt Scott
Name Dropper First Anniversary Facilitator 1
in Blackbaud Financial Edge NXT® APIs

My team and I have connected an app, but when we go to authorize a 503-server unavailable error is returned. Anyone have any insight as to what may be causing this?

Comments

  • Alex Wong
    Alex Wong Community All-Star
    Ninth Anniversary Kudos 5 Facilitator 3 Raiser's Edge NXT Fall 2025 Product Update Briefing Badge

    @Matt Scott
    your info is too vague to know how to help you.

    please provide more details on what API you are calling, how you are calling it, what are the headers, parameters, and body of the request call. Other than 503, what other error message accompanied it.

  • Matt Scott
    Matt Scott
    Name Dropper First Anniversary Facilitator 1

    @Alex Wong

    This is what I was sent by our third party.


    Step1: get Auth code
    URL: https://oauth2.sky.blackbaud.com/authorization?response_type=code
    client_id=xxxxxxxxxx
    redirect_uri=xxxxxxxxxxxxxxx

    Step2: get Token
    URL: https://oauth2.sky.blackbaud.com/token
    Content-Type: application/x-www-form-urlencoded
    grant_type: authorization_code
    code: xxxxxx
    redirect_uri: https://oauthcallback
    client_id: xxxxxxxx
    client_secret: xxxxxxxx

  • Alex Wong
    Alex Wong Community All-Star
    Ninth Anniversary Kudos 5 Facilitator 3 Raiser's Edge NXT Fall 2025 Product Update Briefing Badge

    @Matt Scott
    third party as in you (or your 3rd party) is a consultant helping another org do custom API work? I have not help in such situation as someone from “outside” working “in” to an org's environment, so you will need to wait and see if some other consultant/partner type of user will provide you with more help. My thought are below

    I think you are not providing all the details here, while step 1 “looks” fine, was the redirect_uri configured properly within your application? is your step 1 client_id and redirect_uri provided as query parameter or header? (should be all query parameter)

    Your step 2 is also unclear as to which is query parameter which is header. (i.e. Authorization needs to be header or body of the call, not query parameter, this is the base 64 encoding of your application client id and secret; Content-Type needs to be header; all others should be query parameter)

  • Chris Rodgers
    Chris Rodgers Blackbaud Employee
    Ninth Anniversary Kudos 2 Name Dropper Participant

    Hey @Matt Scott,

    I'm with Blackbaud's SKY API team. We're not hearing of other customers experiencing regular issues with the SKY API Authorization server, and we're not seeing 503 errors in our metrics. Without more details, I suspect this may have been an intermittent Blackbaud Account/ID (sign in) issue, but that's entirely a guess. If your third party is still seeing this, you can file a ticket with Blackbaud Support on their behalf. When filing the ticket, my team will need to know which application experienced this issue, when the issue occurred (if it's no longer happening), and at which point in the Authorization Flow the 503 occurred.

Categories