> For the complete documentation index, see [llms.txt](https://docs.unskript.com/unskript-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.unskript.com/unskript-documentation/runbooks/xrunbooks/create-a-credential.md).

# 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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.unskript.com/unskript-documentation/runbooks/xrunbooks/create-a-credential.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.