SMTP2GO
MESSAGING · MESSAGING
Email and SMS sends, scheduled sends, activity search, and reports on their key.
Acts as the person, not as itself
Each user connects their own account. Every call carries both identities — the agent and the person it is acting for — so the agent can never reach past what that individual can already do.
Credentials never touch the agent
Tokens live in the vault and attach server-side at call time. The agent holds a session, not a secret, and revoking access does not mean rotating a key.
Every call on the record
Who asked, which agent acted, which action ran, and the verdict that let it through — one audit trail across every integration, not one per vendor.
What an agent can do
Each action is granted on its own. An agent allowed to read is not thereby allowed to write, and the scope beside each row is what the acting user must have connected for it to run at all.
smtp2go_patch_api_keys_editWRITEPatch an existing API key ignoring missing properties. Changes the account's shared API Keys. If it names the key this connection was given, every tool here stops working until a new key is pasted.
smtp2go_patch_ip_auth_editWRITEPatch an existing IP Auth ignoring missing properties. Changes which source IP addresses may use this account's API and SMTP. Agentic Fabriq cannot supply a stable egress address -- its nodes use ephemeral public IPs -- so no allow list can be written that keeps this connection working once the list is enforced.
smtp2go_patch_users_smtp_editWRITEPatch an existing SMTP user ignoring missing properties.
smtp2go_post_activity_searchREADReturns events (such as opens, unsubscribes) which match the filters passed. A count of events matching the filter is also included, as this may surpass the maximum of 1,000 items included within the response. This endpoint is rate-limited to 60 requests per minute.
smtp2go_post_allowed_recipients_addWRITEAdd one or more email addresses and domain names to your Allowed Recipients List. Further details of the associated setting are found in the SMTP2GO Guides.
smtp2go_post_allowed_recipients_removeWRITERemove one or more emails addresses or domain names stored in your Allowed Recipients List. Note: In the event that any of the email addresses or domains do not feature in the list, no error will be raised.
smtp2go_post_allowed_recipients_updateWRITEReplace the email addresses and domain names on your Allowed Recipients List using this endpoint. Further details of these modes are found in the SMPT2GO Guides. Note that a post to this endpoint will return a success, even if the setting is not in use. REPLACES the whole list rather than adding to it: every address or domain left out of this call leaves the list. Read the current list first, or use the add/remove tools.
smtp2go_post_allowed_recipients_viewREADReturns the email addresses and domain names on your Allowed Recipients list.
smtp2go_post_allowed_senders_addWRITEAdd one or more email addresses and domain names to your Allowed or Restricted Senders List. How this list of email addresses and domain names are used is shown by the current 'mode' value; if the Restrict Senders setting is on, they will form either a whitelist or blacklist. If the setting is off, the list will be disabled. Further details of the associated setting are found in the SMTP2GO Guides. Details of how this mode can be set via the update end-point, are given further in the documentation. A post to this endpoint will return a success, even if the Restrict Senders setting is not in use.
smtp2go_post_allowed_senders_removeWRITERemove one or more emails addresses or domain names stored in your Allowed or Restricted Senders List. Note: In the event that any of the email addresses or domains do not feature in the list, no error will be raised.
smtp2go_post_allowed_senders_updateWRITEReplace the email addresses and domain names on your Allowed or Restricted Senders List using this endpoint. How the email addresses and domain names are used is defined in the current 'mode' value - further details of these modes are found in the SMPT2GO Guides. Note that a post to this endpoint will return a success, even if the setting is not in use. REPLACES the whole list rather than adding to it: every address or domain left out of this call leaves the list. Read the current list first, or use the add/remove tools.
smtp2go_post_allowed_senders_viewREADReturns the email addresses and domain names on your Allowed or Restricted Senders list, as well as the Restrict Senders setting, which dictates how they are interpreted.
smtp2go_post_api_keys_addWRITEAdd a new API key to your account This endpoint is rate-limited to 5 requests per minute. Mints a new account API Key. The key is returned once and carries the endpoint Permissions given here.
smtp2go_post_api_keys_editWRITEEdit an existing API key. Changes the account's shared API Keys. If it names the key this connection was given, every tool here stops working until a new key is pasted.
smtp2go_post_api_keys_permissionsREADRetrieve a list of endpoints this API Key can use. This endpoint is available to all API Keys.
smtp2go_post_api_keys_removeWRITERemove an existing API key. Changes the account's shared API Keys. If it names the key this connection was given, every tool here stops working until a new key is pasted.
smtp2go_post_api_keys_viewREADRetrieve a list of API keys on this account.
smtp2go_post_archive_emailREADFetch an archived email using the email_id.
smtp2go_post_archive_searchREADRetrieve a list of up to 5,000 archived emails matching the supplied parameters.
smtp2go_post_dedicated_ips_viewREADRetrieve a list of Dedicated IP addresses on this account.
smtp2go_post_domain_addWRITEAdd a sender domain to your account. Note that you must own any domains you wish to include in this list, as you will be required to verify and authenticate the emails sent via that domain. Find full details in the Sender Domains Guide.
smtp2go_post_domain_removeWRITERemove a sender domain from your account. Removes a VERIFIED sender domain from the account; every sender using it stops being able to send until the domain is added and verified again.
smtp2go_post_domain_returnpathWRITEA Return Path Subdomain is used to instruct the server where to return emails that are not deliverable (ie. Bounces). This endpoint allows you to edit a Return Path Subdomain for a particular sender domain. Full details can be found in the Sender Domain Guide.
smtp2go_post_domain_subaccount_accessWRITEAllow subaccounts to send from verified sender domains on the master account.
smtp2go_post_domain_trackingWRITEA Tracking Subdomain is used to monitor your email opens and clicks. This endpoint allows you to edit a tracking subdomain for a particular sender domain. Full details can be found in the Sender Domain Guide.
smtp2go_post_domain_verifyWRITEVerify a sender domain on your account removing the need to wait for the periodic verification every 7 minutes.
smtp2go_post_domain_viewREADReturns a list of sender domains on your account.
smtp2go_post_email_batchWRITESend a batch of emails.
smtp2go_post_email_mimeWRITESend an email by supplying a pre-encoded MIME string.
smtp2go_post_email_scheduled_removeWRITERemoves a scheduled email by ID.
smtp2go_post_email_scheduled_searchREADAllows searching of scheduled emails.
smtp2go_post_email_searchREADRetrieve a list of up to 5,000 sent emails matching the supplied parameters. The filter_query field can be used to create complex filters to make your searching more efficient. Find full details in the Email and Email Archive Guide. Note: Allow around two minutes after delivery for recently sent emails to be included in a search result. This endpoint is deprecated and will not be accessible in future API versions. Please use the Activity Search (https://developers.smtp2go.com/reference/search-activity) endpoint instead.This endpoint is rate-limited to 20 requests per minute.
smtp2go_post_email_sendWRITESend an email by passing a JSON email object.
smtp2go_post_ip_allow_listWRITEEnables/Disables an IP allow list. DO NOT ENABLE THROUGH THIS INTEGRATION. Agentic Fabriq cannot supply a stable egress address -- its nodes use ephemeral public IPs -- so an enabled allow list will refuse every later call from this connection, including this tool, which is the only one that could turn it off again. A successful call here therefore breaks the connection, and the only way back is the SMTP2GO web app. Disabling the list is safe.
smtp2go_post_ip_allow_list_addWRITEAdds an IP address to an allow list. Changes which source IP addresses may use this account's API and SMTP. Agentic Fabriq cannot supply a stable egress address -- its nodes use ephemeral public IPs -- so no allow list can be written that keeps this connection working once the list is enforced.
smtp2go_post_ip_allow_list_editWRITEEdits an existing IP allow list. Changes which source IP addresses may use this account's API and SMTP. Agentic Fabriq cannot supply a stable egress address -- its nodes use ephemeral public IPs -- so no allow list can be written that keeps this connection working once the list is enforced.
smtp2go_post_ip_allow_list_removeWRITERemoves an IP address from an allow list. Changes which source IP addresses may use this account's API and SMTP. Agentic Fabriq cannot supply a stable egress address -- its nodes use ephemeral public IPs -- so no allow list can be written that keeps this connection working once the list is enforced.
smtp2go_post_ip_allow_list_viewREADRetrieves a list of IP Addresses on the allow list along with the list's enabled status.
smtp2go_post_ip_auth_removeWRITERemove an IP Auth entry from your account. Changes which source IP addresses may use this account's API and SMTP. Agentic Fabriq cannot supply a stable egress address -- its nodes use ephemeral public IPs -- so no allow list can be written that keeps this connection working once the list is enforced.
smtp2go_post_ip_auth_viewREADReturns a list of all IP Auth entries that are managed by this account, or details of a specific IP Auth, when you include the [ip_address] in your request. If no entries are available, this will return an empty list.
smtp2go_post_single_sender_emails_addWRITEUse the API to add a single sender email address to your account, to use from which to send mail. If the email address has previously been added and not yet verified, this action will simply resend the verification email.
smtp2go_post_single_sender_emails_removeWRITERemove a single sender email address from your account. Include the address to remove as the email_address parameter.
smtp2go_post_single_sender_emails_viewREADReturns a list of single sender email addresses on your account, along with their verification status. If you include a email_address, the response will only include items matching this search.
smtp2go_post_sms_sendWRITESend an SMS message to one or more numbers, up to a maximum of 100 numbers.
smtp2go_post_sms_summaryREADRetrieve a summary of SMS messages within a certain time range.
smtp2go_post_sms_view_receivedREADView received SMS messages.
smtp2go_post_sms_view_sentREADView sent SMS messages.
smtp2go_post_stats_email_bouncesREADRetrieve a summary of bounces and rejects, for the last 30 days.
smtp2go_post_stats_email_cycleREADRetrieve a summary of your Account activity, including the start and end date of your monthly plan, the number of emails sent this cycle, the number of emails remaining and the number of emails in your monthly allowance.
smtp2go_post_stats_email_historyREADRetrieve a summary of activity from a specified date range (defaults to last 30 days), per sender email address, SMTP username, domain or subaccount.
smtp2go_post_stats_email_spamREADRetrieve a summary of spam complaints and rejects, for the last 30 days.
smtp2go_post_stats_email_summaryREADRetrieve a combination of the email_bounces, email_cycle, email_spam, and email_unsubs calls in one report. Note this call may take longer to complete.
smtp2go_post_stats_email_unsubsREADRetrieve a summary of unsubscribes and rejects, for the last 30 days.
smtp2go_post_subaccount_addWRITEAdds a new subaccount on your master account. Note: This end-point is rate limited to 50 calls per hour.
smtp2go_post_subaccount_closeWRITEChanges the status of an Active subaccount to Closed. Closes a subaccount: its SMTP users and API keys stop sending.
smtp2go_post_subaccount_editWRITEChanges the details on an existing subaccount.
smtp2go_post_subaccount_reopenWRITEChanges the status of a Closed subaccount back to Active.
smtp2go_post_subaccounts_searchREADReturns any subaccounts that match search criteria.
smtp2go_post_suppression_addWRITESuppresses the specified email address or domain.
smtp2go_post_suppression_removeWRITERemoves the suppression on the specified email address or domain.
smtp2go_post_suppression_viewREADReturns your suppressed email addresses and domains.
smtp2go_post_template_addWRITEAdds a new email template that you can use to format your emails.
smtp2go_post_template_deleteWRITEDeletes the specified email template.
smtp2go_post_template_editWRITEChanges details of an existing email template.
smtp2go_post_template_searchREADSearch your collection of email templates. Returns any templates that match your search criteria.
smtp2go_post_template_viewREADReturns details of the email template with the specified ID.
smtp2go_post_users_smtp_addWRITEAdd a new SMTP user to your account. Full details of the available options for new user accounts can be found in the SMTP User Guide.
smtp2go_post_users_smtp_editWRITEUpdate an SMTP user's details with the parameters passed. Full details of the available options for SMTP user accounts is found in the SMTP User Guide.
smtp2go_post_users_smtp_removeWRITERemove an SMTP user from your account.
smtp2go_post_users_smtp_viewREADReturns a list of all SMTP users that are managed by this account, or details of a specific user, when you include the [username] in your request. If no users are available, this will return an empty list.
smtp2go_post_webhook_addWRITEAdd a new webhook with the given configuration. Setup of webhooks can be done on the Settings > Webhooks page in your SMTP2GO control panel.
smtp2go_post_webhook_editWRITEMake changes to a specific webhook using its unique ID.
smtp2go_post_webhook_removeWRITERemove a specific webhook using its unique ID.
smtp2go_post_webhook_viewREADReturns information for configured webhooks.
Often connected alongside
Put SMTP2GO behind one governed endpoint.
Same permissions, same audit trail, whatever else you connect next.