How to get school API info on user obtained from oauth user_id

Max Graves

Is there a way to match the user_id (the UUID) obtained from the OAuth authorization with the correlating user_id in the school api to use endpoints such as getting the User by ID?

Also I'm having trouble understanding the relationship between a BBID and a School endpoint account (education management), as from looking at the documentation it would seem reasonable that you could obtain the school user account that correlates to the information obtained from the OAuth authorization.

I apologize if this is confusing but I'm also confused.

[UPDATE - 1/15/2022]
As I keep trying to figure this out, it seems like the only way is to use:

https://developer.blackbaud.com/skyapi/apis/school/sso-tutorial

Which is extremely odd, for many reasons, but it seems to be a part of the ON API, which is deprecated and not recommended for new applications, so why is there no way to use OAuth 2 to access a user's info from the Education Management side of things.

Also why are there 3 trillion different mentions of a “user_id" across the different documentations including OAuth? Not only do none of them correlate, some of them, such as the OAuth user_id, aren't even an integer, but a string which appears to be a UUID. I have no clue in what way the BBID (whatever the Blackbaud ID really is) correlates to the Education Management account. What's the point of a Blackbaud ID and being able to login with it, if you can't get a user's corelating info in any of the services, mainly Education Management. I'm either incredibly bad at reading documentation or there really is just no standard across the docs.

Suffice to say I'm incredibly confused.

Bryna Gleich

What are you trying to accomplish?

If you're trying to use the API to pull user passwords, that's not possible due to security.

If you're trying to set up a single sign on so users don't have to log into your app, that's possible.

Here's another thread that may be related:

Bryna Gleich

If you're trying to look up the BBEM user via their BBID, that function doesn't currently exist. You can suggest it to our Idea Bank though.

Post the idea to the School category in

Be sure to describe the use case. Other community members can see your idea, vote for it, and add their own comments.

If you want to draw attention to your idea, link the idea to this discussion thread.

Product management reviews the ideas, may ask follow-up questions, and then marks the ideas (planned, complete, will not address, need more info, etc) when they plan roadmaps for future enhancements.

Max Graves

Yes, I'm trying to get the BBEM user associated with a BBID account, as the docs suggest you should be able to do. It just seems very convoluted and unclear in that regard, as currently the only way to get the BBEM data as related to the person signing in is with the old “SSO” method which uses the on api. Also there's no standard or description of User types across the docs, for example I had to concise way to describe user on the school api before you mentioned BBEM. All I'm saying is that as a person who deals with documentation often, these docs appear very inaccurate at times.

Max Graves

I wrote a feature request and linked it below, in my opinion this seems like a common sense feature unless I'm misunderstanding something.