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

# Manage Senders with the Python SDK

> Create, update and list sender profiles via the Zavu Python SDK. Combine phone numbers, WhatsApp accounts and webhooks into routing identities.

Senders are phone numbers or identities used to send messages. Each project can have multiple senders with one designated as default.

## List Senders

```python theme={null}
result = client.senders.list()
for sender in result.items:
    print(sender.id, sender.name, sender.phone_number)
    if sender.is_default:
        print("(Default sender)")

# With pagination
result = client.senders.list(
    limit=50,
    cursor="cursor_xxx"
)
```

## Get Sender

```python theme={null}
result = client.senders.get(sender_id="snd_abc123")

print(result.id)
print(result.name)
print(result.phone_number)
print(result.is_default)
```

## Create Sender

```python theme={null}
result = client.senders.create(
    name="Marketing",
    phone_number="+15551234567",
    set_as_default=True
)

print(result.id)  # snd_xxx
```

### With Webhook

```python theme={null}
result = client.senders.create(
    name="Marketing",
    phone_number="+15551234567",
    webhook_url="https://your-app.com/webhooks",
    webhook_events=["message.inbound", "message.delivered", "message.failed"]
)

# Webhook secret is only returned on create
if result.webhook and result.webhook.secret:
    print(f"Save this secret: {result.webhook.secret}")
```

## Update Sender

```python theme={null}
result = client.senders.update(
    sender_id="snd_abc123",
    name="Support",
    set_as_default=True
)
```

### Update Webhook Configuration

```python theme={null}
result = client.senders.update(
    sender_id="snd_abc123",
    webhook_url="https://new-url.com/webhooks",
    webhook_events=["message.inbound"],
    webhook_active=True
)
```

### Disable Webhook

```python theme={null}
result = client.senders.update(
    sender_id="snd_abc123",
    webhook_active=False
)
```

### Remove Webhook

```python theme={null}
result = client.senders.update(
    sender_id="snd_abc123",
    webhook_url=None
)
```

## Delete Sender

```python theme={null}
client.senders.delete(sender_id="snd_abc123")
```

<Note>
  You cannot delete the default sender. Set another sender as default first.
</Note>

## Regenerate Webhook Secret

If your webhook secret is compromised, generate a new one:

```python theme={null}
result = client.senders.regenerate_webhook_secret(
    sender_id="snd_abc123"
)

print(f"New secret: {result.secret}")
```

<Warning>
  After regenerating the secret, update your webhook handler to use the new secret. The old secret will no longer work.
</Warning>

## WhatsApp Business Profile

Manage the WhatsApp Business Profile for senders with a connected WhatsApp Business Account.

### Get Profile

```python theme={null}
response = client.senders.get_profile(sender_id="snd_abc123")

print(response.profile.about)
print(response.profile.description)
print(response.profile.address)
print(response.profile.email)
print(response.profile.websites)
print(response.profile.vertical)
print(response.profile.profile_picture_url)
```

### Update Profile

```python theme={null}
response = client.senders.update_profile(
    sender_id="snd_abc123",
    about="Your trusted online store",
    description="Best products at competitive prices",
    address="123 Main St, San Francisco, CA",
    email="support@example.com",
    websites=["https://example.com"],
    vertical="RETAIL"
)
```

### Upload Profile Picture

```python theme={null}
response = client.senders.upload_profile_picture(
    sender_id="snd_abc123",
    image_url="https://example.com/logo.png",
    mime_type="image/png"
)
```

<Note>
  Profile methods are only available for senders with a WhatsApp Business Account connected.
</Note>

## Using Senders in Messages

Specify a sender when sending a message:

```python theme={null}
result = client.messages.send(
    to="+14155551234",
    text="Hello!",
    zavu_sender="snd_abc123"
)
```

If no sender is specified, the default sender is used.