Communications

The communications endpoints can be used to send emails & text messages, view notifications, manage custom domains & sender signatures, etc.

Add Domain Name

Adds a domain name that can be used to send more customized email addresses from. By adding a domain name, emails can come from emails such as `username@yourDomainName` instead of `notifications@BoathouseConnect.com`. This gives you more control over the branding of emails sent to your users and stakeholders.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
domain Domain name to link to the whitelabel.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            [{"whitelabel_id":127,"name":"rower.club","spf_verified":"true","spf_host":"rower.club","spf_text_value":"v=spf1 a mx include:spf.mtasv.net ~all","dkim_verified":"true","weak_dkim":"false","dkim_host":"20200913191825pm._domainkey.rower.club","dkim_text_value":"k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQArJ0BjKbRaiombpDUSQS+h3OKhDHXEJf\/M8MTFPk6lI6kHrsCE1c+qv7KBYeQYwC10489ApYt3yF7zSl8uYQvGTlkmWvN0DdIZMG3Y\/hxFMDucQogSpoBU49tNGbefnUjOlrCghaP7GX55oticbVgpeHFvce6TjTUFuD\/HzaxvQIDAQAB","dkim_pending_host":"","dkim_pending_text_value":"","dkim_revoked_host":"","dkim_revoked_text_value":"","safe_to_remove_revoked_key_from_dns":"false","dkim_update_status":"Verified","return_path_domain":"bhconnect-bounces.rower.club","return_path_domain_verified":"true","return_path_domain_cname_value":"pm.mtasv.net","id":1731437},{"whitelabel_id":127,"name":"rowerforms.com","spf_verified":"true","spf_host":"rowerforms.com","spf_text_value":"v=spf1 a mx include:spf.mtasv.net ~all","dkim_verified":"false","weak_dkim":"false","dkim_host":"","dkim_text_value":"","dkim_pending_host":"20200913230024pm._domainkey.rowerforms.com","dkim_pending_text_value":"k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQ6iqOfA8OG2XgbgTHt6YoSvvkebhxWetlsL\/gi8Kxo4WaufrieDH0423sJLF33i8aN\/e51jdcVmrInKkqtEb++p\/cDR5TUnBwWyZBhhHk50zUQ2aDM\/Fbl\/BG5058w9VRBlkzEpym2Tf8975GyCsvXhqWHF7U9xybTE3MBwIDAQAB","dkim_revoked_host":"","dkim_revoked_text_value":"","safe_to_remove_revoked_key_from_dns":"false","dkim_update_status":"Pending","return_path_domain":"bhconnect-bounces-127.rowerforms.com","return_path_domain_verified":"false","return_path_domain_cname_value":"pm.mtasv.net","id":1731476}]
                        
                            []
Success Response Key

Get Domain Names

Retrieves all the domain names and sender signatures for the given organization.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            [{"domain":{"whitelabel_id":1127,"name":"MyRowingClub.com","spf_verified":"true","spf_host":"MyRowingClub.com","spf_text_value":"v=spf1 a mx include:spf.mtasv.net ~all","dkim_verified":"true","weak_dkim":"false","dkim_host":"20210101165713pm._domainkey.MyRowingClub.com","dkim_text_value":"k=rsa; p=MIGfMA0GCSqGSIb3DUAA4GNADCBiQKBgQDEzmGPcDhQxr\/l\/qCI0K0l+kIuh\/GlOPbTe0xQke8ixyoeiNXkkoHY\/hmdLNOEKheL6aKz0YSYEZntriRecrru+xGjHEl82OhvswKxMjp\/9juy+sYr\/O4n5W7hrX7Boo5\/v9ESwDN5FWKolVYraa48yt773fNMMl7OhT7w0W7ZHwIDAQAB","dkim_pending_host":"","dkim_pending_text_value":"","dkim_revoked_host":"","dkim_revoked_text_value":"","safe_to_remove_revoked_key_from_dns":"false","dkim_update_status":"Verified","return_path_domain":"bhconnect-bounces-1127.MyRowingClub.com","return_path_domain_verified":"true","return_path_domain_cname_value":"pm.mtasv.net","id":1661449},"signatures":[{"id":3047165,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"notifications@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Club Notifications","confirmed":"false"},{"id":3047166,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"updates@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Club Updates","confirmed":"false"},{"id":3047172,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"test@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Test","confirmed":"true"}]}]
                        
                            []
Success Response Key

Reload Domain DNS

Rechecks the domain settings for the given domain name to ensure that emails can be sent through Boathouse Connect using the domain name.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
domain_id Id of the domain name to refresh.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            {"whitelabel_id":1129,"name":"MyRowingclub.com","spf_verified":"true","spf_host":"myrowingclub.com","spf_text_value":"v=spf1 a mx include:spf.mtasv.net ~all","dkim_verified":"true","weak_dkim":"false","dkim_host":"20210101165713pm._domainkey.boathouserewards.com","dkim_text_value":"k=rsa; p=MIGfMA0GCSqGSIb3DQEBAQUAA4GNADCBiQKBgQDEzmGPcDhQxr\/l\/qCI0K0l+kIuh\/GlOPbTe0xQke8ixyoeiNXkkoHY\/hmdLNOEKheL6aKz0YSYEZntriRecrru+xGjHEl82OhvswKxMjp\/9juy+sYr\/O4n5W7hrX7Boo5\/v9ESwDN5FWKolVYraa48yt773fNMMl7OhT7w0W7ZHwIDAQAB","dkim_pending_host":"","dkim_pending_text_value":"","dkim_revoked_host":"","dkim_revoked_text_value":"","safe_to_remove_revoked_key_from_dns":"false","dkim_update_status":"Verified","return_path_domain":"bhconnect-bounces-1129.myrowingclub.com","return_path_domain_verified":"true","return_path_domain_cname_value":"pm.mtasv.net","id":1661449}
                        
                            []
Success Response Key

Create Email Sender Signature

Adds a new sender signature for the given domain name.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
domain Domain name to add signature to.
username Username portion of the from email (ex: username@mydomain.com).
name From name for all emails sent with the signature (ex: `Our Club Updates`).
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            [{"domain":{"whitelabel_id":1127,"name":"MyRowingClub.com","spf_verified":"true","spf_host":"MyRowingClub.com","spf_text_value":"v=spf1 a mx include:spf.mtasv.net ~all","dkim_verified":"true","weak_dkim":"false","dkim_host":"20210101165713pm._domainkey.MyRowingClub.com","dkim_text_value":"k=rsa; p=MIGfMA0GCSqGSIb3DUAA4GNADCBiQKBgQDEzmGPcDhQxr\/l\/qCI0K0l+kIuh\/GlOPbTe0xQke8ixyoeiNXkkoHY\/hmdLNOEKheL6aKz0YSYEZntriRecrru+xGjHEl82OhvswKxMjp\/9juy+sYr\/O4n5W7hrX7Boo5\/v9ESwDN5FWKolVYraa48yt773fNMMl7OhT7w0W7ZHwIDAQAB","dkim_pending_host":"","dkim_pending_text_value":"","dkim_revoked_host":"","dkim_revoked_text_value":"","safe_to_remove_revoked_key_from_dns":"false","dkim_update_status":"Verified","return_path_domain":"bhconnect-bounces-1127.MyRowingClub.com","return_path_domain_verified":"true","return_path_domain_cname_value":"pm.mtasv.net","id":1661449},"signatures":[{"id":3047165,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"notifications@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Club Notifications","confirmed":"false"},{"id":3047166,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"updates@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Club Updates","confirmed":"false"},{"id":3047172,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"test@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Test","confirmed":"true"}]}]
                        
                            []
Success Response Key

Delete Email Sender Signature

Deletes a given sender signature. Returns all remaining domains/sender signatures.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
signature_id Id of the signature to delete.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            [{"domain":{"whitelabel_id":1127,"name":"MyRowingClub.com","spf_verified":"true","spf_host":"MyRowingClub.com","spf_text_value":"v=spf1 a mx include:spf.mtasv.net ~all","dkim_verified":"true","weak_dkim":"false","dkim_host":"20210101165713pm._domainkey.MyRowingClub.com","dkim_text_value":"k=rsa; p=MIGfMA0GCSqGSIb3DUAA4GNADCBiQKBgQDEzmGPcDhQxr\/l\/qCI0K0l+kIuh\/GlOPbTe0xQke8ixyoeiNXkkoHY\/hmdLNOEKheL6aKz0YSYEZntriRecrru+xGjHEl82OhvswKxMjp\/9juy+sYr\/O4n5W7hrX7Boo5\/v9ESwDN5FWKolVYraa48yt773fNMMl7OhT7w0W7ZHwIDAQAB","dkim_pending_host":"","dkim_pending_text_value":"","dkim_revoked_host":"","dkim_revoked_text_value":"","safe_to_remove_revoked_key_from_dns":"false","dkim_update_status":"Verified","return_path_domain":"bhconnect-bounces-1127.MyRowingClub.com","return_path_domain_verified":"true","return_path_domain_cname_value":"pm.mtasv.net","id":1661449},"signatures":[{"id":3047165,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"notifications@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Club Notifications","confirmed":"false"},{"id":3047166,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"updates@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Club Updates","confirmed":"false"},{"id":3047172,"whitelabel_id":1127,"domain":"MyRowingClub.com","email_address":"test@MyRowingClub.com","reply_to_email_address":"1127-inbound@wlinbound.MyRowingClub.com","email_name":"Test","confirmed":"true"}]}]
                        
                            []
Success Response Key

Get All Email Sender Signatures

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Get Default Email Sender Signatures

Gets the sender signatures selected for different types of emails sent through Boathouse Connect.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            {"automated_reminders":{"signature_id":3047166,"domain":"MyRowingClub.com","email_address":"updates@MyRowingClub.com","reply_to_email_address":"129-inbound@wlinbound.MyRowingClub.com","email_name":"Club Updates","confirmed":"true"},"bhconnect_notifications":{"signature_id":3047165,"domain":"boathouserewards.com","email_address":"notifications@boathouserewards.com","reply_to_email_address":"129-inbound@wlinbound.MyRowingClub.com","email_name":"Club Notifications","confirmed":"true"}}
                        
                            []
Success Response Key

Delete Default Sender Signature

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
slug Id of message type to remove the default signature for.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            []
                        
                            []
Success Response Key

Update Default Email Sender Signature

Updates the sender signature used for different types of emails sent through Boathouse Connect. Slug options include: 'bhconnect_notifications', 'automated_reminders', and 'other_emails'.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
slug Id of message type to update.
signature_id Id of the signature to set as the default.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            {"automated_reminders":{"signature_id":3047166,"domain":"boathouserewards.com","email_address":"updates@boathouserewards.com","reply_to_email_address":"129-inbound@wlinbound.boathouseconnect.com","email_name":"FORD Updates","confirmed":"true"},"bhconnect_notifications":{"signature_id":3047165,"domain":"boathouserewards.com","email_address":"notifications@boathouserewards.com","reply_to_email_address":"129-inbound@wlinbound.boathouseconnect.com","email_name":"FORD Notifications","confirmed":"true"}}
                        
                            []
Success Response Key

Get System Email Templates

Retrieves all automated email templates that have their send permissions set by the organization. send_email set to `1` indicates that the email template is allowed to be sent to users affiliated with the organization. Contact Boathouse Connect for a full list of email templates.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            [{"whitelabel_id":127,"template_alias":"post-practice-survey","send_email":1,"last_updated":1738641946},{"whitelabel_id":127,"template_alias":"practice-lineups","send_email":1,"last_updated":1738641937},{"whitelabel_id":127,"template_alias":"regatta-entry-lineups","send_email":1,"last_updated":1738641959},{"whitelabel_id":127,"template_alias":"unknown-practice-attendance","send_email":1,"last_updated":1738641926},{"whitelabel_id":127,"template_alias":"unknown-regatta-attendance","send_email":1,"last_updated":1738641974},{"whitelabel_id":127,"template_alias":"unread-notifications","send_email":1,"last_updated":1738641985},{"whitelabel_id":127,"template_alias":"upcoming-charges","send_email":1,"last_updated":1738641911},{"whitelabel_id":127,"template_alias":"usrowing-odr-complete","send_email":1,"last_updated":1738641999}]
                        
                            []
Success Response Key

Update System Email Template Permission

Manually allows or disallows a given email template from being sent to the users affiliated with the organization.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
template_alias Alias of the email template being updated. Contact BC for options.
send_email `0` if sending is disabled, `1` if sending is allowed.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            [{"whitelabel_id":127,"template_alias":"post-practice-survey","send_email":1,"last_updated":1738641946},{"whitelabel_id":127,"template_alias":"practice-lineups","send_email":1,"last_updated":1738641937},{"whitelabel_id":127,"template_alias":"regatta-entry-lineups","send_email":1,"last_updated":1738641959},{"whitelabel_id":127,"template_alias":"unknown-practice-attendance","send_email":1,"last_updated":1738641926},{"whitelabel_id":127,"template_alias":"unknown-regatta-attendance","send_email":1,"last_updated":1738641974},{"whitelabel_id":127,"template_alias":"unread-notifications","send_email":1,"last_updated":1738641985},{"whitelabel_id":127,"template_alias":"upcoming-charges","send_email":1,"last_updated":1738641911},{"whitelabel_id":127,"template_alias":"usrowing-odr-complete","send_email":1,"last_updated":1738641999}]
                        
                            []
Success Response Key

Create New Message

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Get Message

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Change Message Type

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
type Type of message to convert the message to (`text` or `email`).
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Add Group to Message Recipients

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
group_id Id of the group to add to the recipients list.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Add Stakeholders to Message Recipients

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
group_id Id of the group to add all stakeholders of to the recipients list.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Remove Group From Recipients

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
group_id Id of the group to remove from the recipients list.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Remove Stakeholders From Recipients

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
group_id Id of the group to remove all stakeholders from the recipients list.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Update Message Subject Line

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
subject New subject line for the email.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Update Message Body

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
body Body of the email (can be HTML).
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Update Message Send Time

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
scheduled_time UNIX timestamp of when the message should be sent.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Mark Message Ready To Send

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Approve/Decline Message To Send

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
approval `Yes` or `No` as to whether the message is now approved.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
13 Send Communications to Allowed Groups Allowed to send emails / text messages to groups the user is a member of.
14 Approve Communications Approve communications requested to be sent by users not authorized to send communications. Only allowed in groups you are a member of.
15 Manage Communications Stakeholders Allowed to create/manage stakeholder lists for groups you are a member of.

Sample Responses

                            []
                        
                            []
Success Response Key

Delete Scheduled Message

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Get First Open and Click

Retrieves the first time an email was opened and clicked for each recipient that has opened the email or clicked a link in an email.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
message_id Id of the email or text message.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            {"opens":[{"external_id":"0c3e9d08-68d2-4f23-88a3-ad4d3a8e5820","activity":"Open","open_time":1604025869,"name":"Sean Tribe","custid":0,"sent_time":1604010662,"time_from_sent":15207},{"external_id":"765d70c8-d968-4f0e-8845-a10fe45593df","activity":"Open","open_time":1604242176,"name":"John McDaniel","custid":0,"sent_time":1604010662,"time_from_sent":231514},{"external_id":"32f46a7c-cb26-420c-9a3b-da25fdf4decf","activity":"Open","open_time":1604012270,"name":"Michael Testerson","custid":0,"sent_time":1604010662,"time_from_sent":1608},{"external_id":"4aef5d53-ddcd-45bc-aeef-d043f5f191ae","activity":"Open","open_time":1604010719,"name":"Olivia Standard","custid":0,"sent_time":1604010662,"time_from_sent":57}],"clicks":[{"external_id":"765d70c8-d968-4f0e-8845-a10fe45593df","activity":"Click","click_time":1604242179,"name":"Sean Tribe","custid":0,"sent_time":1604010662,"time_from_sent":231517},{"external_id":"4aef5d53-ddcd-45bc-aeef-d043f5f191ae","activity":"Click","click_time":1604027210,"name":"Michael Testerson","custid":0,"sent_time":1604010662,"time_from_sent":16548},{"external_id":"98674899-225d-4afd-acda-5777d0033508","activity":"Click","click_time":1604016013,"name":"Mark Sless","custid":0,"sent_time":1604010662,"time_from_sent":5351}]}
                        
                            []
Success Response Key

Get My Messages

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Get Scheduled Messages

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
approval_required (optional) Whether or not to only grab messages that currently require approval. `Yes`, `No`, or `All`.
type (optional) Type of message. `Email`, `Text`, or `All`.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Get Sent Messages

Returns all the messages sent by the organization via Boathouse Connect. System-level notifications are not included.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
type (optional) Type of messages to retrieve (`Email`, `Text` or `All`).
limit (optional) Maximum number of messages to return (defaults to 1000).
since (optional) UNIX timestamp of the latest message to pull from (based on sort parameter).
sort (optional) `ASC` or `DESC`, Order you want messages to be sorted by send time.
summary_only (optional) `Yes` or `No`, When `Yes`, all of the activity data is available (opens, clicks, bounces, etc.)
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            [{"message_id":59,"whitelabel_id":127,"custid":564,"sender_name":"Michael Test","sent_time":1637882641,"type":"Email","subject":"Sample regatta email","body":"This is a sample email to send to regatta attendees for the upcoming regatta","approved_by":0,"approved_by_name":null,"unique_opens":19,"unique_clicks":0,"recipient_count":1,"recipients":[{"name":"alex madeupperson","email":"alex@merwinsoftware.net","type":"User","custid":571,"external_id":"b37dd95f-e72e-4436-9a2a-00fedfd5942d"},{"name":"Lindsay Test","email":"Lindsay@MerwinSoftware.net","type":"User","custid":565,"external_id":"d93365c1-d209-4e3f-b652-5927f78481bd"}],"activity":[{"message_id":48,"name":"mike winchester","contact":"Test@Test.com","custid":0,"user_type":"Stakeholder","external_id":"6cd637c9-e15a-4ad3-a824-cb03afb26d9d","status":"Sent","sent_time":1615659422,"activity":"Delivery","time_from_sent":29},{"message_id":48,"name":"Bob Tester","contact":"Bob@Test.net","custid":1128,"user_type":"User","external_id":"8478be73-b918-4012-a2cb-dd8559df9b9e","status":"Sent","sent_time":1615659422,"activity":"Open","time_from_sent":48},{"message_id":48,"name":"mike winchester","contact":"Test@Test.com","custid":0,"user_type":"Stakeholder","external_id":"6cd637c9-e15a-4ad3-a824-cb03afb26d9d","status":"Sent","sent_time":1615659422,"activity":"Click","time_from_sent":564}]},{"message_id":58,"whitelabel_id":127,"custid":564,"sender_name":"Michael Merwin","sent_time":1637882641,"type":"Text","subject":"","body":"Sample regatta text message","approved_by":0,"approved_by_name":null,"unique_opens":19,"unique_clicks":0,"recipient_count":1,"recipients":[],"activity":[]}]
                        
                            []
Success Response Key

Get All Email Templates

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
Try It!
Required Permissions
No special permissions required to access this endpoint.

Sample Responses

                            []
                        
                            []
Success Response Key

Create Email Template

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
title Name of the new email template.
subject Subject line for the email.
body Body of the email template.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.

Sample Responses

                            []
                        
                            []
Success Response Key

Add Group to Email Template

Adds a group to the recipients of a given automated email template. Anytime a user joins the group, they will receive the email.

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
group_id Id of the group to assign the template to.
template_id Id of the template to assign to the group.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.

Sample Responses

                            [{"whitelabel_id":127,"email_template_id":1,"subject":"Welcome to Learn-to-Row","template_name":"LTR Welcome","message_body":"This is a welcome email informing you of our LTR offerings!","last_updated":1628219029,"total_sends":14,"total_reads":"7","total_clicks":"4","emails_sent":[{"whitelabel_id":127,"template_id":1,"timestamp_sent":1628222793,"custid":564,"fname":"Michael","lname":"Testington","email_address":"Michaeltest@BoathouseConnect.com","external_id":"0ae700cb-c3d3-43f0-a5ee-aead3cd7be09","read_count":2,"click_count":0},{"whitelabel_id":127,"template_id":1,"timestamp_sent":1628222793,"custid":126526,"fname":"Olivia","lname":"Brown","email_address":"oliviabrown@boathouseconnect.com","external_id":"a265400b-be97-4dd8-ba41-6aaefd55c2ab","read_count":5,"click_count":0}],"groups_linked":[{"whitelabel_id":127,"template_id":1,"group_id":52,"group_title":"Email Testers","group_descr":"Group of users to test emails with."},{"whitelabel_id":127,"template_id":1,"group_id":62,"group_title":"LTR Athletes","group_descr":"All Learn-to-Row athletes"}],"non_linked_groups":[{"whitelabel_id":127,"group_id":44,"group_title":"Super Admin","group_descr":"Access to everything. Able to grant\/revoke permissions for all groups. Able to do everything. Warning: Only add users to this group that should have permission to manage the entire organization. Strongly recommend limiting to organization president and vice-president..."},{"whitelabel_id":127,"group_id":45,"group_title":"Coach","group_descr":"Allowed to create and manage team practices which includes setting lineups, viewing user contact\/personal details (along with emergency contacts), planning regattas and send communications.?"},{"whitelabel_id":127,"group_id":46,"group_title":"General Member","group_descr":"Limited access. Cannot make any changes that affect any other members or the entire organization."}]},[]]
                        
                            []
Success Response Key

Remove Group From Email Template

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
group_id Id of the group to remove the template from.
template_id Id of the template to remove from the group.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.

Sample Responses

                            []
                        
                            []
Success Response Key

Set Join Email Template

Sets a given email template as the automatic email sent to any new user in the organization

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
action `Add` or `Remove`.
template_id Id of the template to remove from the group.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.

Sample Responses

                            [{"whitelabel_id":127,"email_template_id":1,"subject":"Welcome to Learn-to-Row","template_name":"LTR Welcome","message_body":"This is a welcome email informing you of our LTR offerings!","last_updated":1628219029,"total_sends":39,"total_reads":"7","total_clicks":"4","emails_sent":[{"whitelabel_id":127,"template_id":1,"timestamp_sent":1628219285,"custid":564,"fname":"Michael","lname":"Test","email_address":"Michael@Test.net","external_id":"31e37998-e87e-4a93-ba40-dc181c50cb9b","read_count":1,"click_count":0}],"groups_linked":[{"whitelabel_id":127,"template_id":1,"group_id":62,"group_title":"Learn-to-row 2022","group_descr":""}],"non_linked_groups":[{"whitelabel_id":127,"group_id":44,"group_title":"Super Admin","group_descr":"Access to everything. Able to grant\/revoke permissions for all groups. Able to do everything. Warning: Only add users to this group that should have permission to manage the entire organization. Strongly recommend limiting to organization president and vice-president..."},{"whitelabel_id":127,"group_id":45,"group_title":"Coaches","group_descr":"Allowed to create and manage team practices which includes setting lineups, viewing user contact\/personal details (along with emergency contacts), planning regattas and send communications.?"},{"whitelabel_id":127,"group_id":46,"group_title":"General Member","group_descr":"Limited access. Cannot make any changes that affect any other members or the entire organization."},{"whitelabel_id":127,"group_id":106,"group_title":"October Club & Novice Program","group_descr":""},{"whitelabel_id":127,"group_id":113,"group_title":"Certified Scullers 2022","group_descr":"All athletes certified to scull in a 1x"}]}]
                        
                            []
Success Response Key

Update Email Template

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
title Name of the new email template.
subject Subject line for the email.
body Body of the email template.
title (optional) Name of the new email template.
subject (optional) Subject line for the email.
body (optional) Body of the email template.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.

Sample Responses

                            []
                        
                            []
Success Response Key

Update Social Media Link

Parameters
token API Token.
whitelabel_id Whitelabel Id of the organization.
platform Social media platform (facebook, instagram, youtube, twitter).
newurl URL to include as the link.
Try It!
Required Permissions
The authenticated user must hold one of the following permissions to access this endpoint:
IdNameDescription
12 Manage Communications Allowed to change communications settings such as custom domain name settings, send hours, and other email settings.
17 Manage Organization Settings Allowed to change basic organization-related settings, such as uploading logos, setting timezone, etc.

Sample Responses

                            []
                        
                            []
Success Response Key

Don't like coding?

Checkout our integration with Zapier! Zapier is a platform that allows you to connect Boathouse Connect to over 3,000+ other applications & services Go To Zapier




Overview

Actions

About Us

Copyright © 2011-2025 Merwin Software, LLC / Boathouse Connect