> For the complete documentation index, see [llms.txt](https://docs.aohwv.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aohwv.dev/getting-started/10-first-sync.md).

# Step 9 — Run Your First Sync

After deploying AOH Sync and completing system setup, this guide walks you through triggering your first sync and verifying the results.

{% hint style="info" %}
Before starting this guide, confirm your source, target, and provisioning Connector are set up — covered in [Step 6 — Connect a Source System](/getting-started/07-connect-source-system.md), [Step 7 — Connect a Target System](/getting-started/08-connect-target-system.md), and [Step 8 — Set Up Provisioning](/getting-started/09-set-up-provisioning.md).
{% endhint %}

{% stepper %}
{% step %}
**Confirm your Connector's Field Mappings**

Open **Connectors** in the left sidebar and select the Connector that links your Source System to your Target System. Navigate to the [**Field Mappings**](/feature-reference/connectors/field-mappings.md) tab.

Review each mapping to make sure source fields are mapped to the correct target attributes. Pay particular attention to the fields that drive identity matching — typically a unique identifier such as an employee ID or email address. Incorrect mappings here will cause data to land in the wrong attributes or prevent records from being matched on subsequent syncs.

Make any needed adjustments, then save your changes. AOH Sync records each change in [Revisions & History](/feature-reference/connectors/revisions.md), giving you an audit trail of every mapping change.
{% endstep %}

{% step %}
**Set a Schedule or use Run Now**

Navigate to the [**Schedule**](/feature-reference/connectors/schedule.md) tab on the same Connector.

* To run the sync immediately without waiting for a scheduled window, use the **Run Now** option on the Connector. This is the fastest way to validate your configuration.
* To set a recurring sync cadence, configure your schedule here. AOH Sync will run the Connector automatically at the interval you specify.

{% hint style="info" %}
For your first sync, using Run Now lets you see results quickly and catch any mapping or connection issues before committing to a schedule.
{% endhint %}
{% endstep %}

{% step %}
**Watch progress in Sync History**

After triggering the sync, go to the [**Sync History**](/feature-reference/connectors/logs.md) tab on the Connector. The log updates as the sync runs and shows each record processed, the action taken (created, updated, skipped, or errored), and any warnings.

If errors appear, expand the affected rows for details. Common causes include:

* A source field mapped to a required target attribute that is empty or missing for some records.
* A connection interruption to the Source System or Target System.
* A field type mismatch between the source value and the expected target format.

Address any errors, then re-run if needed.
{% endstep %}

{% step %}
**Verify results on the Dashboard and in Browsing Identities**

Once the sync log shows completion, verify the results in two places:

1. [**Dashboard**](/feature-reference/dashboard.md) — Check the summary metrics to confirm the expected number of Identities and Accounts are reflected. The Dashboard updates after each sync run.
2. [**Browsing Identities**](/feature-reference/browsing-identities.md) — Browse the Identities list to spot-check a few records. Confirm that the attributes from your Source System are present and correctly populated on each Identity's detail view.

If the counts or attribute values look wrong, return to [Field Mappings](/feature-reference/connectors/field-mappings.md) and adjust, then run again.
{% endstep %}
{% endstepper %}

## Related

* [Source Systems](/feature-reference/source-systems.md)
* [Target Systems](/feature-reference/target-systems.md)
* [Connectors](/feature-reference/connectors.md)
* [Field Mappings](/feature-reference/connectors/field-mappings.md)
* [Schedule](/feature-reference/connectors/schedule.md)
* [Sync History](/feature-reference/connectors/logs.md)
* [Dashboard](/feature-reference/dashboard.md)
* [Browsing Identities](/feature-reference/browsing-identities.md)


---

# 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.aohwv.dev/getting-started/10-first-sync.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.