# boolean_smtp_ses_iam_selector

> Filters the list of predefined IAM credentials offered in the SES connection form.

Filter · Tier B · Since 1.0.0

When non-empty, the schema adds an "IAM Credential Selection" field so a site can pick a predefined credential (for example, one provisioned by a hosting platform) instead of entering an access key and secret directly; see `boolean_smtp_ses_iam_credentials` for where the corresponding secrets are supplied. Return the available identities, keyed by selector id and mapped to their display label.

## Signature

```php
add_filter( 'boolean_smtp_ses_iam_selector', $callback, 10, 1 );
```

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `$identities` | `array<string, string>` | IAM credential selector id mapped to its display label; empty by default. |

**Returns** `array<string, string>` — The filtered identities.

## Fires in

- [app/Services/Mailer/Transports/SesTransport.php:333](https://github.com/booleanpress/boolean-smtp-src/blob/main/app/Services/Mailer/Transports/SesTransport.php#L333) — `BooleanSmtp\Services\Mailer\Transports\SesTransport::getSettingsSchema()`

## Example

```php
add_filter( 'boolean_smtp_ses_iam_selector', function ( array $identities ) {
    return $identities;
}, 10, 1 );
```