Addresses::Country2

Addresses::Region1

Appointments::ScheduledEvent1

Blog3

Blogs::Author2

Blogs::Category2

Blogs::Post5

Blogs::Tag3

Communities::Ban4

Communities::Bans::ExportAction3

Communities::Bans::UnbanAction2

Communities::Membership5

Communities::Memberships::AddToGroupAction2

Communities::Memberships::BanAction2

Communities::Memberships::ExportAction3

Communities::Memberships::RemoveFromGroupAction2

Communities::Space5

Communities::SpaceGroup5

Communities::Spaces::Post10

Communities::Spaces::Post::Comment8

Communities::Spaces::Post::Comment::Like3

Communities::Spaces::Post::Like3

Communities::Spaces::Post::VideoEmbed4

Community4

Contact7

Contacts::AppliedTag4

Contacts::BillingAddress3

Contacts::EnrollAction4

Contacts::Event2

Contacts::Events::Note5

Contacts::ExportAction4

Contacts::Filter2

Contacts::RunWorkflowAction4

Contacts::SubscriptionChange2

Contacts::Tag5

Contacts::TagAction4

Contacts::UnsubscribeAction4

Contacts::UnsubscribedTopic5

Course5

Courses::Enrollment4

Courses::Lesson5

Courses::LessonCompletion4

Courses::Section5

Courses::Sections::PublishAction4

Discount5

Domain2

Download2

Emails::Address5

Emails::Broadcast9

Emails::Broadcasts::SendAction4

Emails::Domain4

Emails::Settings2

Emails::Template5

Emails::Topic5

Form5

Forms::Field6

Forms::Fields::Option5

Forms::FieldSet5

Forms::Submission5

Forms::Submissions::Answer5

FormSubmission2

Fulfillment6

Fulfillments::Location5

Funnel9

Funnels::CloneAction3

Funnels::ConditionalSplitStep5

Funnels::SplitTestStep5

Funnels::Tag5

Image5

Order5

Orders::AppliedTag4

Orders::Invoice6

Orders::Invoices::Restock2

Orders::LineItems::Change2

Orders::Tag5

Orders::Transaction3

Page10

Product6

Products::Collection4

Products::Price4

Products::Prices::ChangeOption1

Products::Tag5

Products::Variant4

RefineFilter5

Sales::Opportunities::Note5

Sales::Opportunity5

Sales::Pipeline5

Sales::Pipelines::Stage5

Segment5

Shipping::Address5

Shipping::LocationGroup2

Shipping::Package5

Shipping::Profile5

Shipping::Rate5

Shipping::Rates::Name5

Shipping::Zone5

Site2

Store5

Style1

SurveyWorkflow2

SurveyWorkflow::Run2

Team3

Theme4

UrlRedirect7

User3

Video5

Webhooks::Incoming::ExternalPurchaseEndpoint5

Webhooks::Incoming::ExternalPurchaseEvent2

Webhooks::Incoming::ExternalPurchaseProductMapping5

Webhooks::Outgoing::Endpoint5

Webhooks::Outgoing::Event2

Webhooks::Outgoing::EventType1

Workflow8

Workflows::Run3

Workflows::Step6

Workflows::Trigger5

Workspace4

Emails::Settings

Get Email Settings

Changed on Nov 3, 2026

Retrieve email settings for a workspace. A workspace that has never configured its email settings has no persisted record yet; this returns 200 with the empty settings shape (address: null, address_complete: false) rather than a 404, signalling "not set up yet - PUT to configure". Check address_complete here before sending marketing email: see the Business mailing address prerequisite in the Emails Skill.

get/workspaces/{workspace_id}/emails/settings

Request

Base URL
https://myworkspace.myclickfunnels.com/api/v2
Auth
- HTTP bearer
- or OAuth 2
  Authorization codehttps://accounts.myclickfunnels.com/oauth/authorize
  Token URLhttps://accounts.myclickfunnels.com/oauth/token
TypeScript
https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/docs/workspaces/:workspace_id/emails/settings/get.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

workspace_idstring required

Response

workspace_idinteger

Workspace ID

namestring nullable

Business/sender name shown on email broadcasts

hide_brandingboolean

Whether ClickFunnels branding is hidden in the email footer

unsubscribe_footerstring nullable

Custom unsubscribe footer text

footer_alignment'left' | 'center' | 'right'

Alignment of the email footer

address_single_lineboolean

Whether the marketing address renders on a single line

address_completeboolean

True once the marketing address satisfies the email broadcast gate. See the Business mailing address prerequisite in the Emails Skill.

Example response

{
  "workspace_id": 42000,
  "name": "Acme Inc.",
  "hide_branding": false,
  "unsubscribe_footer": null,
  "footer_alignment": "center",
  "address_single_line": false,
  "system_emails_from_address": {
    "email_address": "system@example.com",
    "name": "System Notifications"
  },
  "system_emails_reply_to_address": {
    "email_address": "support@example.com",
    "name": "Support"
  },
  "marketing_emails_from_address": {
    "email_address": "marketing@example.com",
    "name": "Marketing Team"
  },
  "marketing_emails_reply_to_address": null,
  "address": {
    "address_one": "123 Main St",
    "address_two": null,
    "city": "San Francisco",
    "postal_code": "94105",
    "region_name": "California",
    "region": "CA",
    "country": "US"
  },
  "address_complete": true
}

Changes

Nov 3, 2026511d88b30aea Revision changes
- info
  for the path request parameter workspace_id, the type was generalized from integer to string
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history