# Prerequisites

Prior to working on integrating the Socios.com API into your project, there are a few requirements to address. 

Here's a checklist to help you get started.

## **1. Get Your Free Access**

{% hint style="info" %}
We advise you to reach out to your account manager or key point of contact at Socios.com. \
They will guide you through the process of getting your access to the Socios.com API Manager tool. 
{% endhint %}

To obtain your Socios.com API access:

1. Access the [Chiliz Help Centre](https://mediarex.atlassian.net/servicedesk/customer/portal/5).
   1. Submit your email to create an account on the platform.

      <figure><img src="/files/9WWPx6rmRvrCtgN45Z1a" alt="" width="375"><figcaption></figcaption></figure>

      *If you already have an Atlassian account, click "Continue with Atlassian account".*
   2. Choose either "Companies" or "Individuals", depending on your situation.

      <figure><img src="/files/AOPjgUbdzGVpUCexPiVt" alt="" width="563"><figcaption></figcaption></figure>
2. Click on "Complete API Due Diligence" and fill in the form.
3. Click on "API Terms & Conditions" and fill in the form.&#x20;

The Socios.com team will contact you shortly.

## **2. Create Your Application**

Once you have your API access, you need to create a new OAuth 2.0 application in your API settings. You can do this by visiting the [Socios.com Developer Portal](https://partner.socios.com/devportal/apis). Log in, navigate to your API settings, and create a new application. See our [Quick Start](/partner-api/quick-start.md) for more.

{% hint style="danger" %}
Make sure to use our production environment since the sandbox is under construction.
{% endhint %}

## **3. Familiarise Yourself With Our URLs**

You should be aware of the following URLs to smoothly operate with the Socios.com  API:

* **API Base URL**\
  [https://api-public.socios.com](<https://api-public.socios.com >) \
  This is the base URL that you'll use to interact with our APIs.
* **Authorisation URL**\
  [https://partner.socios.com/oauth2/authorize ](<https://partner.socios.com/oauth2/authorize >)\
  This is the URL used for authorising your application with OAuth2.&#x20;
* **Access Token URL**\
  [https://partner.socios.com/oauth2/token ](<https://partner.socios.com/oauth2/token >)\
  This is the URL to use when requesting an access token. \
  The access token is used to authorise your API requests.
* **Revoke Token URL**\
  [https://partner.socios.com/oauth2/revoke ](<https://partner.socios.com/oauth2/revoke >)\
  This is the URL to use when needing to revoke your token, for any reason.

With these prerequisites in place, you should be ready to begin using the Socios.com API. If you have any questions or need any further information, feel free to reach out to your point of contact.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://connect.socios.com/partner-api/prerequisites.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.