> For the complete documentation index, see [llms.txt](https://docs.logsail.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.logsail.com/api-platform/logsail-apis/service-accounts.md).

# Service Accounts

LogSail supports service accounts for 3rd party API access.

## Creating a Service Account

{% hint style="info" %}
**Good to know:** Service accounts are identical to user accounts and the only difference is how the account is used. Service accounts require the sharing of username and passwords with the 3rd party service being integrated with. Read and write access can be explicitly assigned to service accounts to manage how data is being accessed or manipulated on the platform.
{% endhint %}

### Registering a Service Account

Log out of the LogSail console if not already and navigate to the create account view: [Create Account](https://console.logsail.com/register)

<figure><img src="https://2079904743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmZk9Jv2ufxk0FWqBkBQ3%2Fuploads%2F60ebq4PME8tPdMs9qHIq%2FService%20Account%20-%2001.png?alt=media&amp;token=62d117c8-ea81-4990-a42f-dab41c4cb24f" alt=""><figcaption><p>Register View</p></figcaption></figure>

Similar to creating a user account, a service account is done by stepping through the account creation view. A valid email for the service account is required. If this email address cannot be verified similar to user accounts contact [LogSail Support](mailto:support@logsail.com) to override the verification step.

<figure><img src="https://2079904743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmZk9Jv2ufxk0FWqBkBQ3%2Fuploads%2FZLDg0AHoj0YCILTnRGV3%2FService%20Account%20-%2002.png?alt=media&amp;token=53d8d7ab-db96-451f-85ae-29a8d7dd9e3e" alt=""><figcaption><p>Service Account Login</p></figcaption></figure>

### Adding the Service Account to a Group

Once the service account has been created log back into an owner or administrator account and add the new service account to the desired groups.

<figure><img src="https://2079904743-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmZk9Jv2ufxk0FWqBkBQ3%2Fuploads%2FbiWtL2rcypStxqeG3hve%2FService%20-%20Account%20-%2003.png?alt=media&amp;token=8d228ee7-8a4f-4ff1-aa88-6c103f59cd56" alt=""><figcaption><p>Adding Service Account to Group</p></figcaption></figure>

Once the access role is specified, the service account can start making API requests within the group tenancy. Accessing the API requires a `refresh_token` and `access_token` which can be obtained by requesting a set from the authentication API. These steps are documented in the next section.
