# Creating a Service Account

{% hint style="warning" %}
Please note the below steps can only be performed by a Symphony Messaging Pod Administrator as only they will have the necessary administrator privileges to access the Admin Portal. Please do not attempt this if you are not a Pod Administrator and reach out to your internal IT Helpdesk if you are unsure who your Symphony Messaging Pod Administrator is.
{% endhint %}

{% hint style="info" %}
If you are attempting to use the **Developer Sandbox** at [develop2.symphony.com](https://develop2.symphony.com), this section is not relevant for you. Please register for an account at the **Developer Center** at [developers.symphony.com](https://developers.symphony.com) and click on the request link in the welcome email to obtain your sandbox credentials.
{% endhint %}

In order to create a bot and begin your development journey, you must first create a bot user, also known as a service account. You can only do this yourself if you are a pod administrator on your Symphony Messaging pod. Otherwise, please seek assistance from your pod administrator or your internal IT Service Desk if you are unsure who to contact.

## Create a Bot User

### 1. Navigate to your Symphony Messaging Admin Portal for your Pod

For example, <https://mycompany.symphony.com/?admin[^1>]

### 2. Select Create an Account in the left navigation pane

<div align="left"><figure><img src="https://3121587452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB51RkjSmfA_ejydg4M-3415978100%2Fuploads%2FQYhvD3gjIvjafKDeyyxz%2Fimage.png?alt=media&#x26;token=4ab3d610-393c-407c-a4aa-ca69c44d3ad7" alt=""><figcaption></figcaption></figure></div>

### 3. Select the Service Account tab

<div align="left"><figure><img src="https://3121587452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB51RkjSmfA_ejydg4M-3415978100%2Fuploads%2FHtpOhPE71CAVi0mjTSQM%2Fimage.png?alt=media&#x26;token=55f578d7-2b32-4929-bd84-f56fd3b3626b" alt=""><figcaption></figcaption></figure></div>

### 4. Fill in your bot information

The bot username here has to match the username supplied by a bot configuration file exactly.

<div align="left"><figure><img src="https://3121587452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB51RkjSmfA_ejydg4M-3415978100%2Fuploads%2FMvHn1eVMX1dP9Yq0BYl8%2Fimage.png?alt=media&#x26;token=cea7df05-8529-4aae-9057-43359606cde6" alt=""><figcaption></figcaption></figure></div>

### 5. Fill in the RSA Public Key

Paste the entire contents of the *public key* in the **Authentication** section.\
This *public key* has to match the *private key* supplied by a bot.\
If you are unsure how to generate an RSA key pair, use the [Symphony Messaging Generator](https://docs.developers.symphony.com/dev-tools/generator).

<div align="left"><figure><img src="https://3121587452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB51RkjSmfA_ejydg4M-3415978100%2Fuploads%2FPSOQKXYufA196Hy8Yuu9%2Fimage.png?alt=media&#x26;token=883e37ca-02c2-49a8-b6aa-a3769511b407" alt=""><figcaption></figcaption></figure></div>

### 6. Set roles and entitlements

Enable the required roles that your bot requires.

<div align="left" data-full-width="false"><figure><img src="https://3121587452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB51RkjSmfA_ejydg4M-3415978100%2Fuploads%2F8NUVrIa9HhTZZBj4YpCr%2Fimage.png?alt=media&#x26;token=5e5682b6-8cff-4f21-a8e0-35110fdc9b18" alt=""><figcaption></figcaption></figure></div>

Enable the required entitlements that your bot requires.

<div align="left"><figure><img src="https://3121587452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB51RkjSmfA_ejydg4M-3415978100%2Fuploads%2FcoLFQEAVndwBafxrO3oR%2Fimage.png?alt=media&#x26;token=fb62e759-0533-451a-8457-ba91915de57f" alt=""><figcaption></figcaption></figure></div>

{% hint style="info" %}
Navigate to [Bot Permissions](https://docs.developers.symphony.com/bots/overview-of-rest-api/bot-permissions) for a full list of bot roles and privileges.
{% endhint %}

### 7. Confirm Bot Creation

![](https://3121587452-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MB51RkjSmfA_ejydg4M-3415978100%2Fuploads%2FMTmGK3fcd4mftFxzUhrj%2Fimage.png?alt=media\&token=54c1e8d8-4de4-433a-b736-b770243a7041)

[^1]: This is an example address. Your company's pod might be located on a custom domain, in which case simply append **/?admin** behind your pod address to access the Admin Console.