Update an email sender ID

post

https://api.caniphish.com/api/v3/content-library/sender-ids/update-sender-id

Updates an existing email sender ID using the same inputs as create (domainType managed/byo, plus spoofDomain when managed), re-validating domain spoofability where applicable. Platform library sender IDs can be updated too: the save produces a customised tenant-local copy that overrides the platform profile of the same name — the shared platform original is never modified. Rejects the update if no profile with the given sanitized name exists in either library.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

tenantID

string

required

profileName

string

required

displayName

string

domainType

string

enum

Primary choice, mirroring the console form. "managed" uses a CanIPhish sending domain — set spoofDomain to say whether you are spoofing a domain; "byo" (bring-your-own) sends from your own domain via your own infrastructure. Takes precedence over profileType when supplied.

Allowed:

spoofDomain

boolean

Only used when domainType is "managed": true spoofs the customer's own domain (validated for spoofability via SPF/DMARC), false uses a CanIPhish-managed sending domain.

sendingAddress

string

From address. When spoofing (domainType "managed" + spoofDomain true, or profileType "Customer-Managed") the domain is validated for spoofability; for a CanIPhish-managed profile it must be a CanIPhish managed domain; for "byo"/"Customer-Domain" it is your own address.

profileType

string

enum

Alternative to domainType (used only when domainType is omitted). "Customer-Domain" = customer-owned SMTP (BYO, no spoof validation); "Customer-Managed" = managed + spoof a customer domain; "CanIPhish-Managed" = managed, use a CanIPhish domain.

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Updated

400Error