Skip to main content

​
Creating Your User-Agent

Open Library asks every API client to identify itself with a User-Agent header. You create this value yourself; it is not issued by Open Library.

1

Format your User-Agent string

Combine your application name with a contact email address in parentheses.

  • Format: AppName (contact@example.com)
  • Example: AcmeBooksBot (admin@acme.com)
  • Open Library uses this to identify your traffic and apply per-client rate limits (identified clients get higher limits than anonymous ones)
  • A missing or generic value may cause your requests to be throttled or blocked

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • User-Agent
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.