Getting started with the Prepr GraphQL API

Sign up for a Prepr account

Go to signup.prepr.io (opens in a new tab) to create your free account in seconds and you can start exploring Prepr. After your account is created, you'll be prompted to add an environment. Choose to load demo data to get you going quickly.

Get your API URL

Now you have a Prepr account with a demo environment, but before you can make any API requests, you need the API endpoint and access token. The API endpoint is a specific URL that allows you to access a service provided by the API, while the access token grants permission to the API services.

When you add an environment, Prepr provides two API endpoints by default, GraphQL Production and GraphQL Preview. Each of these has a unique access token with their relevant permission scope.

To get an API URL, go to Settings → Access tokens and click GraphQL Production.

Send your first API request

Now you're ready to make your first basic request. You can use the API Explorer to test your API requests directly in Prepr before adding them to your front-end application.

To open the API Explorer, simply click the Open in API Explorer -> link just below the API URL field in the GraphQL Production access token page.

You’ll be redirected to the API Explorer interface which connects to the GraphQL Production endpoint automatically.

For your first query, retrieve all published blog posts available in the demo data like in the list below.

Copy and paste the following query to the Operation pane and click the Run button.

query {
  Posts {
    items {
      _id
      title
    }
  }
}

Once your request is processed, check out the response. You will get a list of all published articles with their identifiers and titles.