# Create a Credential

Any Action that connects to an external service will require a Credential.  To learn how to create a credential to a specific provider, check the section on [Connectors](/unskript-documentation/connnecting/connectors.md).  Each Connector service has instructions on how to add a Credential.

###  Example: Creating a Credential for AWS:

{% embed url="<https://youtu.be/OD-Kd8eqiwE>" %}

1. Under Proxies/Environments, click **Create Credential** (Or you can add a new credential when editing an Action in an xRunBook).
2. Choose AWS as your credential.
3. Name your credential (and add an optional [serviceID](#serviceid))

<figure><img src="/files/IVuuFoRKARxo5MBpE7iD" alt="First screen when adding or editing a Credential"><figcaption><p>Step 1 of adding a Credential</p></figcaption></figure>

4\.  After Clicking next, ypu'll be prompted to add your authorization credentials.  In the case of AWS, it is a key and secret:

<figure><img src="/files/DGkFvYJq5p5kXa6SBgUb" alt=""><figcaption><p>Adding your Key and Secret</p></figcaption></figure>

Now your Credential will be saved. It'll be ready for use in a few seconds.

## ServiceID

When adding a Credential, a serviceID can be added. ServiceID is a variable abstraction of the Credential. &#x20;

When a xRunBook is run in multiple [environments](/unskript-documentation/connnecting/proxies/connect-your-environment.md), different credentials might be used (for example - the AWS connection in dev might be different than the one used in production). &#x20;

To use a serviceID:

1. For your credentials - give them a serviceID (that is the same across all environments).  For example: AWS\_ServiceID.
2. Open your xRunbook, and for each Action, change the credential Slider to ServiceID, and choose the serviceId.
3. Now, when you run the RunBook, you'll be prompted to choose an environment, and unSkript will use the credentials (via the serviceId) for that environment.


---

# 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://docs.unskript.com/unskript-documentation/runbooks/xrunbooks/create-a-credential.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.