Skip to main content

E-mail

Syntax​

Email To            address_or_field
Email CC To         address
Email BCC To        address
Email From          address
Email Subject       text
Email Server        sendgrid
Email APIKey        api_key
Email Attachment    [filename]

Deprecated (non-functional) SMTP commands still parsed but unused by the SendGrid path:

Email Port          port_number
Email Userid        userid
Email Password      password

Parameters​

  • Email To address_or_field: The recipient. If a literal address (e.g., esullivan@hisisp.com), a single report is sent. If a database field name (e.g., email), a separate e-mail is sent to each selected entrant.
  • Email CC To address: Sends a carbon copy to this address.
  • Email BCC To address: Sends a blind carbon copy to this address.
  • Email From address: Your sender address.
  • Email Subject text: The subject line of the e-mail.
  • Email Server sendgrid: Must be sendgrid. Any other server name shows a deprecation dialog and sends nothing.
  • Email APIKey api_key: The SendGrid API key (required for sending).
  • Email Attachment [filename]: Without an argument, sends the listing output as an attachment named rstmp$$$.txt. With a filename, attaches that file while also including the listing in the e-mail body. Use ~ prefix for files in the race directory.
  • Email Port / Email Userid / Email Password: Deprecated. Used only by the removed generic SMTP path; they have no effect when Email Server is sendgrid.

Description​

Sends e-mail from RunScore via SendGrid. You can send a race report to a single recipient or individual results to each entrant who has an e-mail address in the database.

Remarks​

  • Sending is SendGrid-only. Generic ISP SMTP, SendinBlue, and other non-sendgrid servers are deprecated: RunScore shows "Sending email via RunScore SMTP is deprecated. Please use SendGrid or another SMTP server." and does not send.
  • RunScore determines whether to send a single report or individual e-mails based on the Email To value. A literal address sends one report; a field name sends one e-mail per selected record.
  • E-mail sending runs in a background thread, so you can continue using RunScore while e-mails are sent. Each recipient's address appears in the status line at the bottom of the screen.
  • E-mail can only be sent from RSServer, not from RSClient.
  • Only text file attachments are supported. You cannot attach Excel, Word, or other binary files.
warning

Set Page Length to a small number when sending individual e-mails. If you do not, blank lines are inserted that appear at the top of each e-mail.

SendGrid integration​

Race Roster provides free SendGrid access for RunScore users. To use SendGrid:

  1. Obtain a subuser account from support@runscore.com.
  2. Log in to SendGrid and enable Two-Factor authentication.
  3. Create a Sender Identity and verify your e-mail address.
  4. Generate an API key through the Web API integration.
  5. Use Email Server sendgrid and Email APIKey.
warning

E-mails sent through SendGrid may appear with "via sendgrid.net" appended, which can cause spam filtering. Verify your domain with SendGrid to avoid this.

Email from listing files​

The sample 5K race ships with ready-made email listing files:

Setup requires %email_apikey% and %email_from% in Entries.INI (see 5K/CONTEXT.md).

Instant Print cannot send email

The Instant Print template parser (instprnt) does not support the EMAIL APIKEY command. Email requires a listing file.

Examples​

Send a report to a single recipient via SendGrid:

Email To            esullivan@hisisp.com
Email CC To         johnjones@anotherisp.com
Email BCC To        sue_adam@herisp.com
Email From          me@myisp.com
Email Subject       Here are my race results
Email Server        sendgrid
Email APIKey        SG.xxxxxxxxxxxxxxxxxxxx

Send individual results to each finisher with an e-mail address:

Header
Congratulations on finishing the Vernon XX.  Following
is your place, time and pace:
.End of Header
Records/Page        1
Page Length         5
From Page Number    1
To Page Number      1000
No Column Headers
No Page Numbers
No Total
Select              email
<>
Field               place
Field               first name
Squeeze
Field               last name
Squeeze
Field               time
Field               pace
Pace                20K
Email Server        sendgrid
Email APIKey        SG.xxxxxxxxxxxxxxxxxxxx
Email To            email
Email From          runscore@stny.com
Email Subject       Your Vernon XX results