Skip to content

Authentication

The PosterMyWall API supports two authentication methods, depending on what you are accessing.

API key

For calls that do not need a user context, such as /v1/templates, you only need your application’s API key. No user authentication is required.

Pass the API key as the client_id parameter. For instance:

Terminal window
curl -X GET \
'https://api.postermywall.com/v1/templates?client_id=9eqHGgmX2a12345o0Yx341234000abcl&keyword=party'

OAuth 2.0

For calls related to resources owned by a user, such as designs and purchases, you need to authenticate the user with OAuth 2.0:

  • Authorization URL: https://api.postermywall.com/v1/oauth/authorize
  • Token URL: https://api.postermywall.com/v1/oauth/token
  • Scope: all (read access to a user’s designs and purchases)

We recommend using a standard OAuth library to manage this flow for you rather than implementing it by hand.

Once you have an access token, requests look like this:

Terminal window
curl -X GET https://api.postermywall.com/v1/users/[user_id]/downloads \
-H 'Authorization: Bearer [access_token]'

Get your API key

Sign in to your PosterMyWall Developer account to create an app and get an API key.