> ## 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](/features/persistent-sessions).
</Note>

## Create a Profile

Before using a profile, you must create it:

<CodeGroup>
  ```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")
  ```
</CodeGroup>

## Use a Profile

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

<CodeGroup>
  ```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
  ```
</CodeGroup>

## List Profiles

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

## Delete a Profile

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

<Note>
  If Python is not your language of choice, check out our [API Reference](/api-reference/introduction).
</Note>