Use the sync command to upload your local Chrome browser profile — cookies, local storage, extensions, and saved state — directly to WebRun’s cloud. This is the fastest way to get a profile ready for use in sessions.
Sync an Existing Profile
If you’ve already created a profile via the API or dashboard, sync your local browser data to it:
bash <(curl -fsSL https://webrun.ai/sync/sync.sh) --profileId <profileId> --key <apiKey>
| Parameter | Description |
|---|
--profileId | The ID of the existing profile to sync to |
--key | Your WebRun API key |
This uploads your local Chrome profile data to the specified profile, replacing any existing data. The profile status changes to ready once the upload completes.
Create and Upload in One Step
To create a new profile and upload your local data in a single command, omit the --profileId flag:
bash <(curl -fsSL https://webrun.ai/sync/sync.sh) --key <apiKey>
This will:
- Create a new profile on your account
- Upload your local Chrome profile data to it
- Return the new profile ID for use in sessions
Save the profile ID returned by the command — you’ll need it to attach the profile to sessions via profileId.
When to Use Sync
| Scenario | Approach |
|---|
| You’re already logged into sites locally and want to reuse that state | Sync your local profile |
| You want to set up a profile from scratch via automation | Use the API to create a profile, then run a session to populate it |
| You need to back up or transfer a cloud profile | Use the download endpoint |
Next Steps