> For the complete documentation index, see [llms.txt](https://docs.rely.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rely.io/scorecards/usage-guide/creating-a-scorecard.md).

# Creating a Scorecard

When users create a new account in [Rely.io](http://rely.io/) and set up core plugins (Git Provider and Incident Management Provider), they'll see default scorecards and metrics in their account. This helps users get started quickly.

Users also have the option to create their own scorecards that fit their specific business objectives. There are two ways to create scorecards: through the user interface or by using the Public API.

## From the UI

You can create a scorecard from the scorecards catalog by directly providing a valid [scorecard descriptor](/basic-concepts/scorecards.md#scorecard-descriptor).

<figure><img src="/files/P0rohwrfiyMTfRPnV9VK" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
You can **only** create scorecard rules that reference **properties that exist in the blueprint** the scorecard applies to.\
\
Make sure the blueprint descriptor is compliant with whatever you're trying to set before submitting the scorecard.
{% endhint %}

Once you create a scorecard, an automation process will automatically assess the compliance of various entities against the specified ranks and rules in the scorecard. Typically, you can expect the results to arrive within a few seconds.

{% hint style="info" %}
Entities that don't comply with the lowest rank (bronze), will be shown as "No Rank"
{% endhint %}

## From the Public API

You can create scorecards from the Public API by using the endpoint listed below.

{% content-ref url="/pages/TYsaooLVFLywVwLXo4my" %}
[Scorecards](/public-api/scorecards.md)
{% endcontent-ref %}

{% hint style="info" %}
Remember that in order to call Rely.io Public API you need to authenticate before. If this is your first time doing it refer to the [official docs](/public-api.md).
{% endhint %}


---

# 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.rely.io/scorecards/usage-guide/creating-a-scorecard.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.