> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentvault.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Identity and addresses

> Save the name, contact details and addresses your agent fills into checkouts and sign-up forms.

On the Identity and Addresses pages you save the name, contact details and
addresses your agent fills into checkouts. Each takes about 2 minutes.

<Frame caption="The Identity page.">
  <img className="block dark:hidden" src="https://mintcdn.com/self-labs/qQvThJRMtr_jh7i3/images/dashboard/identity-light.webp?fit=max&auto=format&n=qQvThJRMtr_jh7i3&q=85&s=ccafdaafd5b087b294d4f7116a5578a8" alt="The Identity page with First name, Last name, Email, and a Phone field split into Country code and Number, plus a Save changes button." width="2880" height="1800" data-path="images/dashboard/identity-light.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/self-labs/qQvThJRMtr_jh7i3/images/dashboard/identity-dark.webp?fit=max&auto=format&n=qQvThJRMtr_jh7i3&q=85&s=59eec268a876aa08c5c8ae4d500823c6" alt="The Identity page with First name, Last name, Email, and a Phone field split into Country code and Number, plus a Save changes button." width="2880" height="1800" data-path="images/dashboard/identity-dark.webp" />
</Frame>

Your agent fills each detail with a placeholder, and the real value is typed only
on sites you have approved.

## Identity

<Steps>
  <Step title="Open Identity">
    In the sidebar, under **Vault**, click **Identity**.
  </Step>

  <Step title="Fill in Your identity">
    Enter **First name**, **Last name**, **Email** and **Phone**.
  </Step>

  <Step title="Click Save changes">
    The button reads **Saved** for a moment.
  </Step>
</Steps>

Your agent can now fill your name, email and phone into checkouts. It always
uses the saved values, never unsaved edits.

| Field | What it does | Default | Recommendation |
| - | - | - | - |
| **First name**, **Last name** | Fill name boxes, alone or together | Empty | Your name as it appears on orders |
| **Email** | Fills email boxes at checkout | Empty | An inbox you check for order emails |
| **Phone** | Fills phone boxes in any shape. At least 4 digits after the country code, and at most 15 digits counting the country code. Otherwise the form says which rule failed and does not save | Empty | Pick the **Country code**, then type the number |

Below the form, the page says whether your number also fits US checkouts that
split it into three boxes.

### Add another identity

Add one when an agent needs a different email or phone, such as a work address.

<Steps>
  <Step title="Click Add identity">
    It is under **Other identities**.
  </Step>

  <Step title="Enter a Label">
    For example `work`: lowercase letters and digits, up to 16 characters.
  </Step>

  <Step title="Click Add identity">
    Fill in at least a name, email or phone first.
  </Step>
</Steps>

It appears in your agent's token catalog straight away, under its label, next
to your main identity, which is labelled `default`. Tell your agent which label
to use. To remove it, click the trash
icon, then **Delete identity**.

<Frame caption="A second identity labelled work.">
  <img className="block dark:hidden" src="https://mintcdn.com/self-labs/qQvThJRMtr_jh7i3/images/dashboard/identity-other-light.webp?fit=max&auto=format&n=qQvThJRMtr_jh7i3&q=85&s=0f6c72db8e3c4ac3fcf7025b9a648ab5" alt="Other identities table with one identity labelled work, showing a name, an email address and a phone number." width="2336" height="354" data-path="images/dashboard/identity-other-light.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/self-labs/qQvThJRMtr_jh7i3/images/dashboard/identity-other-dark.webp?fit=max&auto=format&n=qQvThJRMtr_jh7i3&q=85&s=2ceaf582dcd8c9baaade37774531594c" alt="Other identities table with one identity labelled work, showing a name, an email address and a phone number." width="2336" height="354" data-path="images/dashboard/identity-other-dark.webp" />
</Frame>

### Older phone numbers

A phone saved before the **Country code** box existed may still be stored as
the text you typed. Until you save it again, your agent's `phone` token fills
that text unchanged, for example `5550100134` with no country code, rather than
the international form `+15550100134`.

To store it in international form:

* **Your identity:** check **Country code** and **Number**. Fill them in if they
  are empty, then click **Save changes**. The button is active only after a
  change, so if both boxes already show your number, retype one digit of it. If
  you save other fields while both phone boxes are empty, the old number is
  removed.
* **Other identities:** these cannot be edited. Delete the identity and add it
  again with the same label, typing the phone with its country code, such as
  `+15550100134`. Its tokens keep the same names, because they are built from
  the label.

## Addresses

<Frame caption="The Addresses page with three saved addresses.">
  <img className="block dark:hidden" src="https://mintcdn.com/self-labs/qQvThJRMtr_jh7i3/images/dashboard/addresses-light.webp?fit=max&auto=format&n=qQvThJRMtr_jh7i3&q=85&s=c55b8cdf498706d6476ca73b06878e88" alt="The Addresses page listing three addresses labelled card1, home and office, each with Tokens, Edit and delete actions." width="2880" height="1800" data-path="images/dashboard/addresses-light.webp" />

  <img className="hidden dark:block" src="https://mintcdn.com/self-labs/qQvThJRMtr_jh7i3/images/dashboard/addresses-dark.webp?fit=max&auto=format&n=qQvThJRMtr_jh7i3&q=85&s=bb1b39fb921bb83b7a66bf708956a41f" alt="The Addresses page listing three addresses labelled card1, home and office, each with Tokens, Edit and delete actions." width="2880" height="1800" data-path="images/dashboard/addresses-dark.webp" />
</Frame>

<Steps>
  <Step title="Click Add address">
    It is at the top of the **Addresses** page.
  </Step>

  <Step title="Enter a Label">
    Lowercase letters and digits, up to 16 characters. See the table below.
  </Step>

  <Step title="Enter the address">
    **Apartment, suite, etc.** is optional. Every other field is required.
  </Step>

  <Step title="Click Add address">
    The address appears in the list.
  </Step>
</Steps>

Your agent can now fill this address by its label. To change it, click **Edit**,
then **Save changes**.

<Warning>
  **Renaming an address replaces its tokens.** The label is part of every token
  for that address, so after you change it, tokens your agent saved with the old
  label stop working with `token_not_found`. Tell your agent to fetch its token
  catalog again.
</Warning>

| Label | Use it for |
| - | - |
| `ship` | Where orders are delivered |
| `bill` | The billing address your bank has on file |

An address you type while adding a card is saved as `card1` or similar. You can
rename it. Words the tokens already use, such as `id`, `addr`, `login`, `card`,
`cvv`, an address part like `city` or an identity field like `email`, are
reserved. The form refuses them, but shows only **That address could not be
saved. Check the fields and try again.**, so pick another label. Your agent cannot see
which address is linked to which card, so tell it the label of each card's
billing address.

<Warning>
  **Billing details must match the card.** A shipping address in a billing form is
  one of the most common reasons a correct checkout is declined.
</Warning>

To delete an address, click the trash icon, then **Delete address**. Check
[Cards](/dashboard/cards) first: a card using it as its billing address is left
without one.

## What happens when…

| Situation | Why | What to do |
| - | - | - |
| A new site asks for approval | Your details fill only on sites you approve | Approve it. See [Destinations](/dashboard/destinations) |
| A phone number is cut short | The box takes a different shape | Your agent should use the country code and national number tokens |
| An address has no tokens | Its label is older than the current format | Rename it to lowercase letters and digits, then have your agent fetch its catalog again |
| You paused all agents | Nothing fills until you resume | Click **Resume all agents** on [Overview](/dashboard/overview#stop-every-agent-at-once) |

## For developers

| Token | Fills |
| - | - |
| `av_id_<field>_<uid>` | Your identity: `first_name`, `last_name`, `full_name`, `email`, `phone` |
| `phone_country`, `phone_national` | The country code and the number without it |
| `phone_area`, `phone_prefix`, `phone_line` | US three-box checkouts. `+1` numbers only |
| `av_id_<label>_<field>_<uid>` | An extra identity, such as `av_id_work_email_<uid>` |
| `av_addr_<label>_<part>_<uid>` | `street1`, `street2`, `city`, `state`, `zip`, `country` |

A deleted address returns `token_not_found`. Every token is on the
[Token catalog](/reference/token-catalog).

**Next:** [Cards](/dashboard/cards) to link a billing address to a card.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.