> ## 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.

# Senders

> Manage sender profiles with the PHP SDK

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

## List Senders

```php theme={null}
$result = $client->senders->list([]);

foreach ($result->items as $sender) {
    echo $sender->id . " " . $sender->name . " " . $sender->phoneNumber . "\n";
    if ($sender->isDefault) {
        echo "(Default sender)\n";
    }
}

// With pagination
$result = $client->senders->list([
    'limit' => 50,
    'cursor' => 'cursor_xxx',
]);
```

## Get Sender

```php theme={null}
$result = $client->senders->get([
    'senderId' => 'snd_abc123',
]);

echo $result->id . "\n";
echo $result->name . "\n";
echo $result->phoneNumber . "\n";
echo $result->isDefault . "\n";
```

## Create Sender

```php theme={null}
$result = $client->senders->create([
    'name' => 'Marketing',
    'phoneNumber' => '+15551234567',
    'setAsDefault' => true,
]);

echo $result->id . "\n"; // snd_xxx
```

### With Webhook

```php theme={null}
$result = $client->senders->create([
    'name' => 'Marketing',
    'phoneNumber' => '+15551234567',
    'webhookUrl' => 'https://your-app.com/webhooks',
    'webhookEvents' => ['message.inbound', 'message.delivered', 'message.failed'],
]);

// Webhook secret is only returned on create
if ($result->webhook?->secret) {
    echo "Save this secret: " . $result->webhook->secret . "\n";
}
```

## Update Sender

```php theme={null}
$result = $client->senders->update([
    'senderId' => 'snd_abc123',
    'name' => 'Support',
    'setAsDefault' => true,
]);
```

### Update Webhook Configuration

```php theme={null}
$result = $client->senders->update([
    'senderId' => 'snd_abc123',
    'webhookUrl' => 'https://new-url.com/webhooks',
    'webhookEvents' => ['message.inbound'],
    'webhookActive' => true,
]);
```

### Disable Webhook

```php theme={null}
$result = $client->senders->update([
    'senderId' => 'snd_abc123',
    'webhookActive' => false,
]);
```

### Remove Webhook

```php theme={null}
$result = $client->senders->update([
    'senderId' => 'snd_abc123',
    'webhookUrl' => null,
]);
```

## Delete Sender

```php theme={null}
$client->senders->delete([
    'senderId' => '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:

```php theme={null}
$result = $client->senders->regenerateWebhookSecret([
    'senderId' => 'snd_abc123',
]);

echo "New secret: " . $result->secret . "\n";
```

<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

```php theme={null}
$response = $client->senders->getProfile('snd_abc123');

echo $response->profile->about . "\n";
echo $response->profile->description . "\n";
echo $response->profile->address . "\n";
echo $response->profile->email . "\n";
echo implode(', ', $response->profile->websites ?? []) . "\n";
echo $response->profile->vertical . "\n";
echo $response->profile->profilePictureUrl . "\n";
```

### Update Profile

```php theme={null}
$response = $client->senders->updateProfile('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

```php theme={null}
$response = $client->senders->uploadProfilePicture('snd_abc123', [
    'imageUrl' => 'https://example.com/logo.png',
    'mimeType' => '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:

```php theme={null}
$result = $client->messages->send([
    'to' => '+14155551234',
    'text' => 'Hello!',
    'Zavu-Sender' => 'snd_abc123',
]);
```

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