{"id":30794001,"url":"https://github.com/sendgrid/sendgrid-cli","last_synced_at":"2025-09-05T16:26:35.359Z","repository":{"id":33879070,"uuid":"159394653","full_name":"sendgrid/sendgrid-cli","owner":"sendgrid","description":"The SendGrid CLI (Command Line Interface) is a tool that helps you to interact with SendGrid services from the command line. ","archived":false,"fork":false,"pushed_at":"2024-11-07T21:46:42.000Z","size":652,"stargazers_count":25,"open_issues_count":14,"forks_count":4,"subscribers_count":88,"default_branch":"master","last_synced_at":"2025-06-27T11:41:28.451Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sendgrid.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-11-27T20:24:27.000Z","updated_at":"2025-04-22T04:17:38.000Z","dependencies_parsed_at":"2024-11-07T22:26:13.457Z","dependency_job_id":"63b8ce9a-0e1d-4d1a-9c9f-c3aca40e93b2","html_url":"https://github.com/sendgrid/sendgrid-cli","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/sendgrid/sendgrid-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fsendgrid-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fsendgrid-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fsendgrid-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fsendgrid-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sendgrid","download_url":"https://codeload.github.com/sendgrid/sendgrid-cli/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sendgrid%2Fsendgrid-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273782732,"owners_count":25167205,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-05T02:00:09.113Z","response_time":402,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-09-05T16:26:30.299Z","updated_at":"2025-09-05T16:26:35.342Z","avatar_url":"https://github.com/sendgrid.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SendGrid CLI\n\nThe SendGrid CLI (Command Line Interface) is a tool that helps you to interact with SendGrid services from the command line.  It is helpful for automating routine tasks.  The SendGrid CLI removes the need to write code to perform common management activites of the SendGrid platform like uploading a CSV file and enabling/disabling webhooks.\n\n![animated example](sendgrid-cli.gif)\n\n# Prerequisites\n\n* SendGrid Account\n* Tested with NodeJS v8.12.0\n\n# Installation\n\n* Clone this project\n* `cd sendgrid-cli`\n* `npm install`\n* Rename `.env_sample` to `.env` and update the values\n\n## A Note on API Key and API Token\n\nIn the `.env_sample`, you will notice two environment variables, `SENDGRID_API_KEY` and `SENDGRID_TOKEN`.  For certain commands, you will need to use `SENDGRID_TOKEN`.  To learn how to retrieve this token [here](RETRIEVE_TOKEN.md).\n\n# Usage\n\nThis command line interface implements a limited set of commands.\n\n* `./sg list-apikeys`: List API keys\n* `./sg subuser-admins`: Iterate over all subusers and list all teammates (including role) for each subuser (requires `SENDGRID_TOKEN` see note above)\n* `./sg contacts upload`: Upload contacts from a CSV file (fields: email, first_name, last_name)\n* `./sg webhooks`: Manage Event and Inbound Parse webhooks\n\nThese will output JavaScript Objects that are human readable.\n\nYou can also prepend `DEBUG=sg:*` for additional debug logging (not much yet).\n\nDebug namespaces:\n* `sg:client`\n* `sg:utils`\n* `sg:contacts-upload`\n* `sg:subuser-admins`\n* `sg:webhooks-add-parse`\n* `sg:webhooks-disable-event`\n* `sg:webhooks-enable-event`\n\n# Todos\n\n* Pipe from one command into another (need to output JSON strings to stdout)\n\n# License\n\n[LICENSE](LICENSE)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsendgrid%2Fsendgrid-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsendgrid%2Fsendgrid-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsendgrid%2Fsendgrid-cli/lists"}