API
The GraphQL endpoint
The legacy REST API has numerous endpoints; the GraphQL API v1 has a single endpoint:
https://api.event1.io/graphql
The endpoint remains constant no matter what operation you perform.
Authentication
Most queries require authentication, or will only return public data when authentication is not provided. For those cases where it is not required, this will be mentioned in the documentation for each query.
There are two ways to authenticate with the eventOne API:
If authentication information is invalid or omitted, an error message will be returned with status code 401:
{
"message": "401 Unauthorized"
}
OAuth 2.0
OAuth 2.0 is recommended for third-party applications that access the API on behalf of a user. It allows users to grant your application access without sharing their credentials.
See the Authorization Code Grant Flow documentation for a step-by-step guide on obtaining an access token.
Once you have an access token, pass it in the Authorization header:
curl --header "Authorization: Bearer ACCESS_TOKEN" https://api.event1.io/graphql
Personal access tokens
Personal access tokens are best suited for personal scripts, automation, and direct API access. They do not expire and remain valid until revoked.
Pass a personal access token in the Private-Token header:
curl --header "Private-Token: nY0mqSjNT.2bb5895e-f205-4e9a-a93a-283cc8c65e69" https://api.event1.io/graphql
You can create and manage personal access tokens on your account page.
Authorization
See Permissions.
Data Models
See Voyager.