Get an SMTP config

GET

/v1/email/smtp/configs/{api_key_id}

curl -X GET "https://us1.platform.bird.com/v1/email/smtp/configs/{api_key_id}" \
  -H "Authorization: Bearer $TOKEN"

Returns the SMTP send-option config stored for the given API key. Returns a 404 if you haven't set a config for that key — the key still accepts SMTP submissions, using your organization's default pool, the transactional category, and tracking on.

Response Payload

api_key_id

string

आवश्यक

ID of the API key this config applies to, the same key your SMTP client authenticates with. One config exists per key.

ip_pool_id

nullable string

ID of the IP pool that SMTP sends with this key use, or ipp_shared for the shared pool. null when this key uses your organization's default pool.

tags

array of object

आवश्यक

Structured {name, value} labels applied to every message submitted over SMTP with this key — the same tags used by the email sending API. See EmailMessageSendRequest for how tags are used for filtering and analytics.

चाइल्ड एट्रिब्यूट दिखाएँ

tags.name

string

आवश्यक

Tag name. ASCII letters, digits, underscore, and hyphen only. Case-sensitive. Maximum 32 characters.

tags.value

string

आवश्यक

Tag value. ASCII letters, digits, underscore, and hyphen only. Case-sensitive. Maximum 64 characters.

track_opens

boolean

आवश्यक

Whether open events are tracked for messages submitted over SMTP with this key.

track_clicks

boolean

आवश्यक

Whether click events are tracked for messages submitted over SMTP with this key.

created_at

string

आवश्यक

updated_at

string

आवश्यक

curl -X GET "https://us1.platform.bird.com/v1/email/smtp/configs/{api_key_id}" \
  -H "Authorization: Bearer $TOKEN"