Welcome to the RingCentral Community

Make sure to review our Terms of Use and Community Guidelines.

Please note the community is currently under maintenance and is read-only.

Home » Developers

Engage Access Token / API Token (Unauthorized 401)

Tags: engage voice, rest api

Jul 29, 2021 at 2:18pm • 2 replies • 0 likes

Dylan Bowman

https://developers.ringcentral.com/engage/voice/guide/authentication/auth-legacy

Followed the instructions located here to generate an auth token and successfully got an auth token back with a POST to the https://portal.virtualacd.biz/api/v1/auth/login with my username/password. The next step is to use that auth token to generate an API token. I did a POST to https://portal.vacd.biz/api/v1/admin/token with the "X-Auth-Token" header and value of my auth token and get a 401 unauthorized. I tried to POST to the other one at https://portal.virtualacd.biz/api/v1/admin/login and get a 404 not found. I am considered a "super admin" with all the privileges I need to be able to access and generate an API token. Why is it saying I am unauthorized?

I have also attempted following these directions to generate an engage access token but have no idea what platformId is and there is no direction as to where I need to find that information from.
https://developers.ringcentral.com/engage/voice/guide/authentication/auth-engage

Please help...

2 Answers

Craig Chan answered on Jul 30, 2021 at 3:00pm

Looks like there is a typo there (or cut and paste error).

First, you only belong to one platform "vacd" or "virtualacd". Looks like your account is on virtualacd.biz. You should just use that server for your API requests.

To create a permanent API token, use this instead:

POST https://portal.virtualacd.biz/api/v1/admin/token X-Auth-Token: {authTokenOrApiToken}

Notice that the endpoint is token and not login.

For platformId, you should contact your CSM. There's an "Also Note" on this page about it: https://developers.ringcentral.com/engage/voice/guide/authentication/auth-engage.

Anirban answered on Jul 30, 2021 at 12:13pm

I guess @Phong Vu can help here. Tagging him in the question for better visibility

Becky-Community_Manager answered on Jul 29, 2021 at 2:55pm

Hey

A new Community is coming to RingCentral!

Posts are currently read-only as we transition into our new platform.

We thank you for your patience
during this downtime.

Try Workflow Builder

Did you know you can easily automate tasks like responding to SMS, team messages, and more? Plus it's included with RingCentral Video and RingEX plans!

Try RingCentral Workflow Builder

PRODUCTS
RingEX
Message
Video
Phone

OPEN ECOSYSTEM
Developer Platform
APIs
Integrated Apps
App Gallery
Developer support
Games and rewards

RESOURCES
Resource center
Blog
Product Releases
Accessibility

QUICK LINKS
App Download
RingCentral App login
Admin Portal Login
Contact Sales