SendGrid — Connect it to MokonyxSocial

This guide walks you through connecting SendGrid (Twilio SendGrid) so MokonyxSocial can broadcast your Joomla content as email — either a single/test send or a campaign to a contact list. One thing to know up front: deliverability depends on your SendGrid account being verified (an authenticated sender or domain), because unverified senders get blocked or land in spam.

What you need

• A Twilio SendGrid account (there's a free tier).
• A verified sender identity or authenticated sending domain — SendGrid won't deliver mail until you have one.
• A SendGrid API key with Mail Send permission (add Marketing permission if you'll use lists).
• Optionally, a Marketing contact list to send your campaign to.

Get your credentials

API key api_key (required)

This is a SendGrid API key that lets MokonyxSocial send mail on your account. Give it Mail Send access (and Marketing access too if you plan to use list_id).

Here's how to get it:

1. Log in at https://app.sendgrid.com.
2. First, verify a sender: go to Settings → Sender Authentication and either Verify a Single Sender (quick — verifies one from-address) or Authenticate Your Domain (recommended — adds DNS records for the best deliverability). Mail won't send until at least one of these is done.
3. Go to Settings → API Keys → Create API Key.
4. Name it, choose Restricted Access, and enable Mail Send (plus Marketing if you're using lists). Click Create & View.
5. Copy the key right away — it starts with SG. and is shown only once. Paste it into the api_key field.

If you lose the key, there's no way to view it again — just create a new one and delete the old.

List ID list_id (optional)

This is the ID of a SendGrid Marketing contact list you want to send to. Leave it blank for a simple single send (like to one fixed test address).

Here's how to find it:

1. In SendGrid, go to Marketing → Contacts → Lists.
2. Open the list you want — its List ID (a UUID like a1b2c3d4-...) shows in the list details and the URL.
3. Copy that ID into the list_id field. (Your API key needs Marketing access for this to work.)

Set it up in MokonyxSocial

1. In Joomla admin, go to Components → MokonyxSocial → Services → New.
2. Choose SendGrid.
3. Enter your api_key (and a list_id if you're sending to a list).
4. Click Send Test to verify, then Save & Close and make sure it's Published.

Verify

Check the recipient inbox for your test message, then confirm the send in SendGrid under Activity (the Email Activity feed) — it shows Processed/Delivered/Bounced status for each message.

Troubleshooting

• "401 Unauthorized" — the API key is wrong, revoked, or got truncated when you pasted it. Create a fresh key and re-copy the whole thing.
• "403 Forbidden" / "from address does not match a verified Sender Identity" — your sender or domain isn't authenticated yet. Finish Sender Authentication first.
• It sends but lands in spam — you used single-sender verification instead of domain authentication. Authenticate your domain (SPF/DKIM) to improve deliverability.
• A list send does nothing — your API key is missing the Marketing scope, or the list_id is wrong or empty. Fix the key permissions and re-copy the List ID.

Notes & limits

• Free and lower tiers cap how many emails you can send daily/monthly, so big broadcasts may need a paid plan.
• Marketing (list) sends and single transactional sends use different SendGrid subsystems — using list_id requires Marketing access on the key.
• Always include an unsubscribe option in list/marketing mail to stay CAN-SPAM and GDPR compliant.
• Keep your API key secret — anyone who has it can send mail as your account.