{"id":19000995,"url":"https://github.com/pepipost/pepipost-sdk-php","last_synced_at":"2025-10-18T06:16:12.374Z","repository":{"id":55063847,"uuid":"55968324","full_name":"pepipost/pepipost-sdk-php","owner":"pepipost","description":"The Official Pepipost PHP API library","archived":false,"fork":false,"pushed_at":"2020-09-01T15:37:44.000Z","size":383,"stargazers_count":20,"open_issues_count":9,"forks_count":15,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-06-19T23:46:21.873Z","etag":null,"topics":["email","pepipost","php","php-email-sending","php-mail","php-sdk","sdk","send-email-with-attachment","transactional-emails"],"latest_commit_sha":null,"homepage":"https://pepipost.com","language":"PHP","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/pepipost.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-04-11T11:57:27.000Z","updated_at":"2025-02-11T21:32:33.000Z","dependencies_parsed_at":"2022-08-14T10:50:11.868Z","dependency_job_id":null,"html_url":"https://github.com/pepipost/pepipost-sdk-php","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/pepipost/pepipost-sdk-php","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-sdk-php","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-sdk-php/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-sdk-php/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-sdk-php/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pepipost","download_url":"https://codeload.github.com/pepipost/pepipost-sdk-php/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pepipost%2Fpepipost-sdk-php/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274537050,"owners_count":25303962,"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-10T02:00:12.551Z","response_time":83,"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":["email","pepipost","php","php-email-sending","php-mail","php-sdk","sdk","send-email-with-attachment","transactional-emails"],"created_at":"2024-11-08T18:09:29.605Z","updated_at":"2025-10-18T06:16:07.330Z","avatar_url":"https://github.com/pepipost.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"![pepipostlogo](https://pepipost.com/wp-content/uploads/2017/07/P_LOGO.png)\n\n[![Packagist](https://img.shields.io/packagist/php-v/pepipost/pepipost-sdk-php.svg?style=flat-square)](https://packagist.org/packages/pepipost/pepipost-sdk-php)\n[![Packagist](https://img.shields.io/packagist/dt/pepipost/pepipost-sdk-php.svg?style=flat-square)](https://packagist.org/packages/pepipost/pepipost-sdk-php)\n[![Packagist](https://img.shields.io/github/contributors/pepipost/pepipost-sdk-php.svg)](https://github.com/pepipost)\n[![Packagist](https://img.shields.io/packagist/l/pepipost/pepipost-sdk-php.svg)](https://packagist.org/packages/pepipost/pepipost-sdk-php)\n[![Open Source Helpers](https://www.codetriage.com/pepipost/pepipost-sdk-php/badges/users.svg)](https://www.codetriage.com/pepipost/pepipost-sdk-php)\n[![Twitter Follow](https://img.shields.io/twitter/follow/pepi_post.svg?style=social\u0026label=Follow)](https://twitter.com/pepi_post)\n\n## Official PHP Code library for [Pepipost](http://www.pepipost.com/?utm_campaign=GitHubSDK\u0026utm_medium=GithubSDK\u0026utm_source=GithubSDK)\nThis  SDK contains methods for easily interacting with the Pepipost Email Sending API to send emails in a few seconds.\n\nWe are trying to make our libraries community driven and we need your help in building the right things the right way you. Your opinion is very much valued so please share comments, create [issues](https://github.com/pepipost/pepipost-sdk-php/issues) and [pull requests](https://github.com/pepipost/pepipost-sdk-php/pulls).\n\n## Table of Contents\n* [Installation](#installation)\n* [Quick Start](#quickstart)\n* [Announcements](#announcements)\n* [Roadmap](#roadmap)\n* [About](#about)\n* [License](#license)\n\n\u003ca name=\"installation\"\u003e\u003c/a\u003e\n## Installation (OS Friendly)\n\nFor a smooth installation process, we have categorized installation process according to OS:\n\n1. [Build SDK on Windows without any IDE.](https://github.com/pepipost/pepipost-sdk-php/blob/master/windows-installation-1.md)\n2. [Build SDK on Windows/Linux with IDE.](https://github.com/pepipost/pepipost-sdk-php/blob/master/windows-installation-2.md)\n3. [Build SDK on Linux.](https://github.com/pepipost/pepipost-sdk-php/blob/master/linux-installation.md)\n\n### Prerequisites\n* 1. [PHP \u003e=5.4.0](http://php.net/manual/en/install.php)\n* 2. [Composer](https://getcomposer.org/download/)\n* 3. [CURL](https://curl.haxx.se/)\n* 4. A free account on Pepipost. If you don't have a one, click [here](https://app.pepipost.com/index.php/signup/registeruser?utm_campaign=GitHubSDK\u0026utm_medium=GithubSDK\u0026utm_source=GithubSDK) to signup and get 30,000 emails free every month.\n\n### Setup Global Variables\n\nSetup the [PEPIPOST API KEY](https://app.pepipost.com/app/settings/integration) in the library to start sending emails. For example:\n\n1. Copy the API KEY from your Pepipost account by navigating to Settings --\u003e Integrations.\n2. Edit the sample code and replace `PEPIPOST_API_KEY` which the one you just copied.\n3. Now the library is ready to authenticate with Pepipost servers for sending emails.\n\n\u003ca name=\"quickstart\"\u003e\u003c/a\u003e\n## Quick Start\n\nDevelopers already familar with GIT, Composer and some of the other handy tools can just refer the below steps to quick start with the integration. \n\n\u003e If you are not sure of how to integrate this library within your environment, then please refer to our detailed [installation](#installation) guide above.\n\n1. Check php version using below command. Required PHP \u003e=5.4.0. \n \n  ```php -v```\n \n2. Verify if the Composer is installed using the below command: \n  \n  ```composer --version```\n \n3. Clone this repository on your machine using below command:\n \n  ```git clone https://github.com/pepipost/pepipost-sdk-php.git testSDK```\n \n4. Change directory \n \n  ```cd testSDK```\n \n5.  Below will install all the requirement needed to run this library. After installing, a vendor directory will get auto-created\n \n  ```composer install```\n \n6. Copy the code and paste in test.php from [simple-usage.php](https://github.com/pepipost/pepipost-sdk-php/blob/master/simple-usage.php) or [sampleExample](https://github.com/pepipost/pepipost-sdk-php#sample-code-for-testphp) .\n \n  ```cp simple-usage.md test.php```\n  \n7. Get your API key and Sending Domain from your Pepipost account. \n  \n  * **apikey** will be available under Login to Pepipost -\u003e Settings -\u003e Integration  \n  * **Sending Domain** will be available under Login to Pepiost -\u003e Settings -\u003e Sending Domains \n\n```\n  *Note :: Domains showing with Active status on Sending Domain dashboard are only allowed to send any sort of emails.* In case there are no Sending Domain added under your account, then first add the domain, get the DNS (SPF/DKIM) settings done and get it reviewed by our compliance team for approval. Once the domain is approved, it will be in ACTIVE status and will be ready to send any sort of emails. \n```\n\n8. Make the required changes in your script test.php (Adding the apikey and Sending Domain is mandatory).\n \n Change your **```$apiKey = 'api-XX-key-XX-here'```** to **```$apiKey = 'api-key-of-your-pepipost-account';```**\n \n Similarly, update your Sending Domain from:\n \n **```$body-\u003efrom-\u003efromEmail = 'admin@myfirsttest.com';```** to **```$body-\u003efrom-\u003efromEmail = 'admin@your-active-domain-on-pepipost';```**\n\n9. Update the rest of the email related payload like Recipent email address, content of the email etc. Below is the sample code with details of payload:\n\n\n## Sample Code for test.php\n\n```php\n\u003c?php\n\nrequire_once \"vendor/autoload.php\";\nuse PepipostLib\\Models;\nuse PepipostLib\\Exceptions;\n\n$apiKey = '96c909c62bcc1dfdacef7dfdda34ea8477';\n\n$client = new PepipostLib\\PepipostClient($apiKey);\n$sendController = $client-\u003egetMailSend();\n\n$body = new Models\\Send;\n$body-\u003efrom = new Models\\From;\n$body-\u003efrom-\u003eemail = 'hello@your-registered-domain-with-pepipost';\n$body-\u003efrom-\u003ename = 'Pepipost';\n$body-\u003esubject = 'Pepipost Test Mail from PHP SDK';\n\n\n$body-\u003econtent = array();\n$body-\u003econtent[0] = new Models\\Content;\n$body-\u003econtent[0]-\u003etype = Models\\TypeEnum::HTML;\n$body-\u003econtent[0]-\u003evalue = '\u003chtml\u003e\u003cbody\u003eHello [%NAME%], Email testing is successful. \u003cbr\u003e Hope you enjoyed this integration. \u003cbr\u003e\u003c/html\u003e';\n\n$body-\u003epersonalizations = array();\n$body-\u003epersonalizations[0] = new Models\\Personalizations;\n$body-\u003epersonalizations[0]-\u003eattributes = PepipostLib\\APIHelper::deserialize('{\"NAME\":\"User\"}');\n$body-\u003epersonalizations[0]-\u003eto = array();\n\n$body-\u003epersonalizations[0]-\u003eto[0] = new Models\\EmailStruct;\n$body-\u003epersonalizations[0]-\u003eto[0]-\u003ename = 'to-address@mydomain.name';\n$body-\u003epersonalizations[0]-\u003eto[0]-\u003eemail = 'my-first-user';\n\n$body-\u003esettings = new Models\\Settings;\n$body-\u003esettings-\u003efooter = true;\n$body-\u003esettings-\u003eclickTrack = true;\n$body-\u003esettings-\u003eopenTrack = true;\n$body-\u003esettings-\u003eunsubscribeTrack = true;\n\ntry {\n  $result = $sendController-\u003ecreateGenerateTheMailSendRequest($body);\n  var_dump($result);\n} catch (PepipostLib\\APIException $e) {\n    echo 'Caught APIException: ',  $e-\u003egetMessage(), \"\\n\"; \n}\n?\u003e\n\n\n```\n\nFor more information about the parameters, we would like to recommend our [API docs](https://developers.pepipost.com/email-api/sendEmail)\n\n10. Run your script to send your first test email\n\n ```php test.php```\n  \n   This will give you following output:\n   \n ```json\n {\n\t\"data\": {\n\t\t\"message_id\": \"e8820eeb0ee94807f1ce88652b1dd627\"\n\t},\n\t\"message\": \"OK\",\n\t\"status\": \"success\"\n}\n ```\n\n\u003ca name=\"announcements\"\u003e\u003c/a\u003e\n# Announcements\n\nv5.1.0 has been released! Please see the [release notes](https://github.com/pepipost/pepipost-sdk-php/releases/tag/v5.1.0) for details.\n\nAll updates to this library are documented in our [releases](https://github.com/pepipost/pepipost-sdk-php/releases). For any queries and feedbacks, feel free to reach out us at dx@pepipost.com\n\n\u003ca name=\"roadmap\"\u003e\u003c/a\u003e\n## Roadmap\n\nIf you are interested in the future direction of this project, please take a look at our open [issues](https://github.com/pepipost/pepipost-sdk-php/issues) and [pull requests](https://github.com/pepipost/pepipost-sdk-php/pulls). We would love to hear your feedback.\n\n\u003ca name=\"about\"\u003e\u003c/a\u003e\n## About\npepipost-php-sdk library is guided and supported by the Pepipost Developer Experience Team.\nThis pepipost-php-sdk library is maintained and funded by Pepipost Ltd. The names and logos for pepipost-php-sdk are trademarks of Pepipost Ltd.\n\n\u003ca name=\"license\"\u003e\u003c/a\u003e\n## License\nThis code library was semi-automatically generated by APIMATIC v2.0 and licensed under The MIT License (MIT). \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpepipost%2Fpepipost-sdk-php","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpepipost%2Fpepipost-sdk-php","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpepipost%2Fpepipost-sdk-php/lists"}