Architecture decisions worth making before you go too far

No dark-mode styles — this email renders the same in a dark client.

Environment separation, grant lifecycle, webhook reliability — the patterns that hold up at scale.

A few decisions made early save a lot of rework later.

Most developers reach production and realize there were a handful of architecture choices that would have been much easier to get right from the start. Here are the ones that come up most often.

Environment separation

Set up distinct Nylas applications for development, staging, and production — each with its own API key, client ID, and connector configuration. This lets you adjust scopes, test connector changes, and iterate without any risk to production users or data.

Grant lifecycle handling

Grants expire. When a user changes their password, revokes access, or lets an OAuth token lapse, their grant stops working — and your app needs to handle that gracefully.

Subscribe to grant.expired and account.sync_error webhook events and build a re-authentication flow before you go live. Catching this in production without a recovery path is one of the most common avoidable incidents teams run into.

Webhook reliability

Nylas stops retrying after 3 failed delivery attempts. If your endpoint has availability issues or returns errors consistently, you'll miss events. Implement retry logic with exponential backoff on your end, monitor your webhook status in the dashboard, and treat webhook delivery as a first-class reliability concern.

Scope minimization

Only request the scopes your use case actually needs. Beyond the good practice angle, requesting restricted Google scopes triggers a full security assessment — don't request them speculatively. Start narrow and expand if needed.

The MCP server - for agentic workflows

If you're building an AI agent that needs live access to email, calendar, or contacts, the Nylas MCP server works with Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, and any MCP-compatible client.

Install via CLI - one command registers with your agent:

brew install nylas/nylas-cli/nylas

nylas mcp install

EXPLORE THE NYLAS CLI REFERENCE
(https://d5hYdz04.na1.hubspotlinks.com/Ctc/Y+113/d5hYdz04/VWXYkR6w2L4hW4VVT-v2hgCTXW1f4B6k5V2yT5N6fpSWF3lcq-W7Y8-PT6lZ3pyN5qZs48ycKphW4pdR-y6WzYgtW65tB_P3V6L8pW3MNd9T6DDWV7VB6nwX6mQYbZW7s-zTC2x4zhBW6GBLMK297X3RW3CvZ8Z2qfL9lW5wlDmP6_KR0XW8KZXZ_98NG0ZN5QMV80ztJcXW97qgYN3b7m6NW68ZqMW3-585SW4R4X5K8ccbz5W5084d65zLFdRVck4DF4SCncHVrl5cn2dT79kW7_HZJh6BRFP6N587hdwlr_-HW4-wzxS4LRYqRW61ntC82T3WNwW3GJggZ2ZsHxfW4vMhSj4kWDpbVPKsqF4krlqPW82zmSl4Gg5_SVNzWsb8m2LvBf2sC8pY04 )

P.S. Nylas is now native in the coding agents you're already using.

The Nylas CLI, Nylas skill, and Claude Code plugin are all live. One command connects whatever stack you're on to the full Nylas API. Read the 'get started' doc. (https://d5hYdz04.na1.hubspotlinks.com/Ctc/Y+113/d5hYdz04/VWXYkR6w2L4hW4VVT-v2hgCTXW1f4B6k5V2yT5N6fpSWY3lcq-W8wLKSR6lZ3lxN1htrM-tqgF5Vs5ntr3q0HSpN3ZnFXBwLFmSW9dnbgl7QLc1BW2Dmz9W1SFDfGW6T13142Q5L_SW6XbNXp992bkFV3KXY55gTvgQW7tMwW_679tzmW6Qn9h38Cn0hXW2vQnQk1crRxLVhzbYH6ZHMddN4fJ_PTLqYkFV6XhCd8gd2FqW56PGd97L4rh3VLw0CL6DfstQW1wFfQX94TjmgN8BqY0jfqvKBW6kTTXx2t1v9RN6gxWPwtPp4RVSTy7F93xx3CN6TK6TZj3zq7W5kPCdx4V1Kz5N4TsG7dwVCy6W4SwF5-4DbJsHV-GtMp6_JykrW69CCDg2nYcR1W671JS-30m7Rrf85glnC04 )

LinkedIn (https://d5hYdz04.na1.hubspotlinks.com/Ctc/Y+113/d5hYdz04/VWXYkR6w2L4hW4VVT-v2hgCTXW1f4B6k5V2yT5N6fpSWF3lcq-W7Y8-PT6lZ3nRW837kFS7m1RlGW35pZjt7CMd5jW8qCrrF63KdcyW23PH3d6_DZyRW8xYvwf5k1l3-W1mWQf052cJY8N4bbz4x8vSQZW8FklFl4DzhhDW6Dr_JQ6nFym-W1pXKP_4wsgsQW88BKTQ7xNNfZW8WCTxJ6kN9VQW4tDlFz8mcTLrN3Yp0X7174WkW3RjCwj2BNlZbN44_WZGNTnq5W8mWXby9lnclLW3S82fD8phtW1W309lNg5KDwX6N6R39_MG8WJQW11_KHN47CV-jW6TP-Np26ng_FW4PrSvv8MzlK3W7Zr56z9ljKBQW2DTzL847X6sYW8Gq8Fp2R-6X1dTqlxC04 )

X (https://d5hYdz04.na1.hubspotlinks.com/Ctc/Y+113/d5hYdz04/VWXYkR6w2L4hW4VVT-v2hgCTXW1f4B6k5V2yT5N6fpSWl3lcq-W7lCdLW6lZ3pYW6pz1M-8YVwq2V1jgQF8Jwrd0W8FK2B14Pq1FgW5JckbS85-1Y4N21QKc37N1rCW7BR9fg3x46LQW3SC4Ct8sc5wrN1CdDNnGWCJSW2YT58m6rQJQsW6CM65b1bDmT5N1xczg8jBq8BN5B8Z7XncVvZW7l5-3c5gKqPdW1lQjHw5sy0H5N8rR5DKR9d1rW9fyF216Hw-mVVm76N33Ty4wsW8-6dWh4yRR2-W4dMvLG33kBjpVtGrjh5TtDRgW2XVcqQ7VnVVQW4qZfpH77Z7hlW285Blx2F4dbqW8vL5tv33FC3nd3h--C04 )

YouTube (https://d5hYdz04.na1.hubspotlinks.com/Ctc/Y+113/d5hYdz04/VWXYkR6w2L4hW4VVT-v2hgCTXW1f4B6k5V2yT5N6fpSWl3lcq-W7lCdLW6lZ3kVW1T9kHD4kv9l5W1cX3bJ6X9YDfVj2ldr2nsC7qW8jW-Yt1hvRxXW1kPNCw52CcxTW7dVWmY4vZyckN2NTkYZ2z0kNW5plyj63TwyQ9W33H-NS60ScDdW5C-Y1B4j_W-YW2VfVfv4n0Q3tW3_GNr22lpzFcW97057t6fM3pwW9hlc5k2pyGWMMZ4QrDWHdk9W62MlKl8q74X-W3BwC_61mMS-wW5B9QdJ6TnpR5V_Wqnx5DhnQyW5nkP6f35VrfZN4Y5H7WzVwchW6v350P41JqyzW724pLw2yD6JwW36Txw91WJFL5f6N320C04 )

github (https://d5hYdz04.na1.hubspotlinks.com/Ctc/Y+113/d5hYdz04/VWXYkR6w2L4hW4VVT-v2hgCTXW1f4B6k5V2yT5N6fpSWl3lcq-W7lCdLW6lZ3l4N1ffZ7x8GHqbW1fbLP83p05G9W15r_7C3XrgvJN8zk2Wr9Fr13W8pWppV2pxmfLW10zgMD8jWpPjW3Q0fXd2pnv2BW54Lj_r2jmlYbM_KvGJcnTy-W7wVm2C2Tx933W2DK-Nz5240tVW8F9wfm5WDvqNW3ZhFLZ3SQ4vcW98XfBp1rtVTNVyhPRV6-vmBbW801klR34LKGRVQHRS_3cyhn8W5W6_rh60zCjDW7m1c-z106C9DW8gKKrR7PJpJjW6g3kTP5hn5l6W4C3FmS2PTmxbW8z-6pZ1f5RWqVBqf8z25myFdf1pShhl04 )

Nylas, 2100 Geng Rd. #210, Palo Alto, CA 94303, USA

Unsubscribe (https://hs-45023718.s.hubspotemail.net/hs/preferences-center/en/direct?data=W2nXS-N30h-MkW2r0g3P3GLCPhW3djn063FgFLtW1_pmzc20X1N5W1XlXWq4hDGWHW4rBG802HJTxtW1_pPsm41Tq3RW2p98tr1Qk535W2WF4Tr4rmxSzW1By7B02MN7BnW2qS1qm4cKG49W3Qz_9T36CWVvW3XYhpt2Kn8nsW30KX1D2zxT0TW1Z5prG2xx9vjW237FnS3bm9LKW3LDVQt1BvDMGW3XVMhs3JTz3-W2vLdYB3M64z-W234Svj2t1jYJW2p7vtd3S_c5qW3NVqkk2nYkJBW3F8l_p4tf_jyW47v6GL23085lW1LjflD41rwrRW2PS5363Cj1ntW3djPv-218lkMW3dp02-21q5zLW251JqM41Cz-WW2CTCq-3DNwTVW253Q4V3QWtQ5W4hNdhC4r6g6tW3gfhVS1BgZV3W32zMXN2TM6B_W2xWClD2RCmLyW4kJ_Hg3H7m3GW21pJ5K1QBbcDW2HPlFj3j7HjzW2FThDS43F73VW3GYY462r8BsvW2t2x4t4r8MJmW3N-Lj3385FPLW3Zr4tG3dhbWnW2PQqLZ2qDV3FW2PQTCq34lYTTW43xf-h1S2KPrW32KfB83P2zwvW2KVdW22PkFrqW30JCR538lzhzW2v-xDM32mW2nW3gw0TZ2Wg5c1W45BSD049lwDZW4px6Bt38hFDMW23hBgc4pmnPzW326_fm3ZxT23W4fRf811_6nWnW2-GQyF2Pl2B8W1XdG_d230Gf9W32pHlV47m_4_W3QSsJF2C_DH3W3yNZ8f3NMHTmW3g1dcw3_YL52W346V_036kTyGf3gxfGL04&_hsenc=p2ANqtz-_MHlDQeBYhnmKcpQOoE5slz4IXmapTzE6s9EQQnRjQjdZMs9_ZPzv8LVO4DAH1Siv5Tzx8sxNEr1RBfOMhHutiQsnsKMBV4XqlPdnj4Y4FF4SOSb3bMRXMNLbVWsPRk4wo8ukN&_hsmi=422472937 )
Manage preferences (https://hs-45023718.s.hubspotemail.net/hs/preferences-center/en/page?data=W2nXS-N30h-MkW2r0g3P3GLCPhW3djn063FgFLtW1_pmzc20X1N5W1XlXWq4hDGWHW4rBG802HJTxtW1_pPsm41Tq3RW2p98tr1Qk535W2WF4Tr4rmxSzW1By7B02MN7BnW2qS1qm4cKG49W3Qz_9T36CWVvW3XYhpt2Kn8nsW30KX1D2zxT0TW1Z5prG2xx9vjW237FnS3bm9LKW3LDVQt1BvDMGW3XVMhs3JTz3-W2vLdYB3M64z-W234Svj2t1jYJW2p7vtd3S_c5qW3NVqkk2nYkJBW3F8l_p4tf_jyW47v6GL23085lW1LjflD41rwrRW2PS5363Cj1ntW3djPv-218lkMW3dp02-21q5zLW251JqM41Cz-WW2CTCq-3DNwTVW253Q4V3QWtQ5W4hNdhC4r6g6tW3gfhVS1BgZV3W32zMXN2TM6B_W2xWClD2RCmLyW4kJ_Hg3H7m3GW21pJ5K1QBbcDW2HPlFj3j7HjzW2FThDS43F73VW3GYY462r8BsvW2t2x4t4r8MJmW3N-Lj3385FPLW3Zr4tG3dhbWnW2PQqLZ2qDV3FW2PQTCq34lYTTW43xf-h1S2KPrW32KfB83P2zwvW2KVdW22PkFrqW30JCR538lzhzW2v-xDM32mW2nW3gw0TZ2Wg5c1W45BSD049lwDZW4px6Bt38hFDMW23hBgc4pmnPzW326_fm3ZxT23W4fRf811_6nWnW2-GQyF2Pl2B8W1XdG_d230Gf9W32pHlV47m_4_W3QSsJF2C_DH3W3yNZ8f3NMHTmW3g1dcw3_YL52W346V_036kTyGf3gxfGL04&_hsenc=p2ANqtz-_MHlDQeBYhnmKcpQOoE5slz4IXmapTzE6s9EQQnRjQjdZMs9_ZPzv8LVO4DAH1Siv5Tzx8sxNEr1RBfOMhHutiQsnsKMBV4XqlPdnj4Y4FF4SOSb3bMRXMNLbVWsPRk4wo8ukN&_hsmi=422472937 )

Accession

nse/nylas/2026-09-17/1707

From

Joel Garcia · tips@nylas.com

Sent

17 September 2026 · 14:00 UTC