From a87e69d3b0e2cfe8ed1df0708c1f744b1756e811 Mon Sep 17 00:00:00 2001
From: nikkel <nikkel@noreply.example.org>
Date: Fri, 20 Mar 2020 01:44:05 +0700
Subject: [PATCH] Update 'README.md'

---
 README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 56 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 83d97d3..54f347b 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,57 @@
-# postman-php
+# Postman for PHP
 
-A PHP library for the Postman email platform
\ No newline at end of file
+This library helps you send e-mails through [Postman](https://postman.prmail.vn) in PHP 5.4 and above.
+
+## Installation
+
+Install the library using [Composer](https://getcomposer.org/):
+
+```
+$ composer require postman/postman
+```
+
+## Usage
+
+Sending an email is very simple. Just follow the example below. Before you can begin, you'll
+need to login to our web interface and generate a new API credential.
+
+```php
+// Create a new Postman client using the server key you generate in the web interface
+$client = new Postman\Client('https://postman.yourdomain.com', 'your-api-key');
+
+// Create a new message
+$message = new Postman\SendMessage($client);
+
+// Add some recipients
+$message->to('john@example.com');
+$message->to('mary@example.com');
+$message->cc('mike@example.com');
+$message->bcc('secret@awesomeapp.com');
+
+// Specify who the message should be from. This must be from a verified domain
+// on your mail server.
+$message->from('test@test.postman.io');
+
+// Set the subject
+$message->subject('Hi there!');
+
+// Set the content for the e-mail
+$message->plainBody('Hello world!');
+$message->htmlBody('<p>Hello world!</p>');
+
+// Add any custom headers
+$message->header('X-PHP-Test', 'value');
+
+// Attach any files
+$message->attach('textmessage.txt', 'text/plain', 'Hello world!');
+
+// Send the message and get the result
+$result = $message->send();
+
+// Loop through each of the recipients to get the message ID
+foreach ($result->recipients() as $email => $message) {
+    $email;            // The e-mail address of the recipient
+    $message->id();    // Returns the message ID
+    $message->token(); // Returns the message's token
+}
+```