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

# Manage Profiles

> Create, list, and delete browser profiles

> [!NOTE]
>
> For an overview of how profiles work, see [Persistent Sessions](https://docs.smooth.sh/features/persistent-sessions.md).

## Create a Profile

Before using a profile, you must create it:

```python Python theme={null}
from smooth import SmoothClient

client = SmoothClient(api_key="cmzr-YOUR_API_KEY")

# Create a new profile
client.create_profile(profile_id="my-profile")
```

## Use a Profile

Pass the `profile_id` when creating a session or running a task:

```python Python theme={null}
# Use the profile in a session
with client.session(profile_id="my-profile", url="https://example.com") as session:
    session.run_task("Log in with my credentials")
    # Authentication is now saved to the profile
```

## List Profiles

```python Python theme={null}
response = client.list_profiles()
print(f"Profile IDs: {response.profile_ids}")
```

## Delete a Profile

```python Python theme={null}
client.delete_profile(profile_id="my-profile")
```

> [!NOTE]
>
> If Python is not your language of choice, check out our [API Reference](https://docs.smooth.sh/api-reference/introduction.md).


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