🗂️ Connect another system to Vyer with a service account, a member that signs in to the API with a token and has a role like anyone else.
You need the Admin or Owner role.
Create the account
On the Members page, click Create a service account. Give it a Name that says which system it is for, and click Create service account.
The account's page opens with the token under Access token. Click Copy and store the token where the other system can read it. It is shown this once; after you leave the page it stays hidden.
A new service account is an Editor on all sites. To narrow it, change Role or Site access under Role & access, as for any member. Changes are saved at once. See Limit a member to some sites.
The account appears in the members list with a robot icon, and Added by shows who created it.
Call the API
The other system sends GraphQL requests to https://app.vyer.com/graphql with the header Authorization: Bearer followed by the token. It sees and changes exactly what its role allows, and its changes show up in the activity log under the account's name. A token is valid for 10 years. Contact support for the API reference; see Reach us from the app.
Replace a lost or leaked token
On the Members page, click the service account's name.
Under Access token, click Reset token and confirm Generate new token. The old token stops working at once.
Click Copy and put the new token into the other system.
A service account cannot be removed from the organization. To cut a system off, reset its token and keep the new one to yourself, or set the role to Viewer.
If it doesn't work
Copy is grayed out
The token is shown only right after it is created or reset. Click Reset token and copy the new one then.
Requests are answered with Token has been revoked
Someone generated a new token for the account. Use the new one.
There is no Create a service account button
Only Admins and Owners create service accounts.