# POST /transformations — Create Transformation

> Product: **Pabbly Hook** (v1)
> Base URL: `https://hook.pabbly.com/api/v1`
> Auth: Basic via `Authorization` header
> Canonical: `/hook/transformation/create-transformation`

Create a transformation rule that modifies incoming webhook payloads before they're forwarded to downstream services.

**Body parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| name | string | No |  |
| code | string | No |  |

**Example request body:**

```json
{
    "name": "fourth Transformation",
    "code": "(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === 'active') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = 'inactive'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers['X-Item-Count'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error('customerId is missing');  } } catch (error) { console.error('Transformation error:', error.message);  throw error;} return request;}"
}
```

**Code examples:**

_cURL_

```curl
curl -X POST https://hook.pabbly.com/api/v1/transformations \
  -u {{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}} \
  -H "Content-Type: application/json" \
  -d '{
    "name": "fourth Transformation",
    "code": "(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === 'active') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = 'inactive'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers['X-Item-Count'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error('customerId is missing');  } } catch (error) { console.error('Transformation error:', error.message);  throw error;} return request;}"
  }'
```

_Ruby_

```ruby
require 'net/http'
require 'json'

uri = URI('https://hook.pabbly.com/api/v1/transformations')
request = Net::HTTP::Post.new(uri)
request.basic_auth '{{YOUR_API_KEY}}', '{{YOUR_SECRET_KEY}}'
request['Content-Type'] = 'application/json'
request.body = "{\"name\":\"fourth Transformation\",\"code\":\"(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === 'active') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = 'inactive'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers['X-Item-Count'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error('customerId is missing');  } } catch (error) { console.error('Transformation error:', error.message);  throw error;} return request;}\"}"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

data = JSON.parse(response.body)
```

_Python_

```python
import requests
from requests.auth import HTTPBasicAuth

response = requests.post(
    'https://hook.pabbly.com/api/v1/transformations',
    auth=HTTPBasicAuth('{{YOUR_API_KEY}}', '{{YOUR_SECRET_KEY}}'),
    json={
    'name': 'fourth Transformation',
    'code': '(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === 'active') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = 'inactive'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers['X-Item-Count'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error('customerId is missing');  } } catch (error) { console.error('Transformation error:', error.message);  throw error;} return request;}'
},
)

data = response.json()
```

_PHP_

```php
<?php
$ch = curl_init('https://hook.pabbly.com/api/v1/transformations');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'POST');
curl_setopt($ch, CURLOPT_USERPWD, '{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}');
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_POSTFIELDS, '{"name":"fourth Transformation","code":"(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === \'active\') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = \'inactive\'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers[\'X-Item-Count\'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error(\'customerId is missing\');  } } catch (error) { console.error(\'Transformation error:\', error.message);  throw error;} return request;}"}');

$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
```

_Java_

```java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;

String credentials = Base64.getEncoder().encodeToString("{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}".getBytes());

HttpClient client = HttpClient.newHttpClient();
HttpRequest.Builder builder = HttpRequest.newBuilder()
    .uri(URI.create("https://hook.pabbly.com/api/v1/transformations"))
    .header("Authorization", "Basic " + credentials)
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"name\":\"fourth Transformation\",\"code\":\"(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === 'active') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = 'inactive'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers['X-Item-Count'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error('customerId is missing');  } } catch (error) { console.error('Transformation error:', error.message);  throw error;} return request;}\"}"));

HttpRequest request = builder.build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
```

_Node.js_

```node
const credentials = Buffer.from('{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}').toString('base64');

const response = await fetch('https://hook.pabbly.com/api/v1/transformations', {
  method: 'POST',
  headers: {
    'Authorization': `Basic ${credentials}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "name": "fourth Transformation",
    "code": "(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === 'active') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = 'inactive'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers['X-Item-Count'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error('customerId is missing');  } } catch (error) { console.error('Transformation error:', error.message);  throw error;} return request;}"
  }),
});

const data = await response.json();
```

_Go_

```go
package main

import (
    "fmt"
    "io"
    "net/http"
    "strings"
)

func main() {
    payload := strings.NewReader("{\"name\":\"fourth Transformation\",\"code\":\"(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === 'active') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = 'inactive'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers['X-Item-Count'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error('customerId is missing');  } } catch (error) { console.error('Transformation error:', error.message);  throw error;} return request;}\"}")
    req, _ := http.NewRequest("POST", "https://hook.pabbly.com/api/v1/transformations", payload)
    req.Header.Set("Content-Type", "application/json")
    req.SetBasicAuth("{{YOUR_API_KEY}}", "{{YOUR_SECRET_KEY}}")

    res, _ := http.DefaultClient.Do(req)
    defer res.Body.Close()
    body, _ := io.ReadAll(res.Body)
    fmt.Println(string(body))
}
```

_.NET_

```dotnet
using System.Net.Http;
using System.Net.Http.Headers;
using System.Text;
using System.Threading.Tasks;

var credentials = Convert.ToBase64String(Encoding.ASCII.GetBytes("{{YOUR_API_KEY}}:{{YOUR_SECRET_KEY}}"));

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://hook.pabbly.com/api/v1/transformations");
request.Headers.TryAddWithoutValidation("Authorization", $"Basic {credentials}");
request.Content = new StringContent("{\"name\":\"fourth Transformation\",\"code\":\"(request, context) => {let itemCounter = 0;request.payload.items = request.payload.items || [];request.payload.items.forEach(item => {if (item.status === 'active') {itemCounter++;item.updated_at = new Date().toISOString(); } else {  item.status = 'inactive'; } });request.payload.summary = {activeItemCount: itemCounter, totalItems: request.payload.items.length};request.headers['X-Item-Count'] = itemCounter.toString(); request.queryParams.processedAt = new Date().toISOString();try { if (!request.payload.customerId) {   throw new Error('customerId is missing');  } } catch (error) { console.error('Transformation error:', error.message);  throw error;} return request;}\"}");
request.Content.Headers.ContentType = new MediaTypeHeaderValue("application/json");

var response = await client.SendAsync(request);
var data = await response.Content.ReadAsStringAsync();
Console.WriteLine(data);
```

---

**Other endpoints in Transformation:**

- [GET /transformations/{{transformationId}} — Get Single Transformation By Trs_id](/hook/transformation/get-single-transformation-by-trs-id)
- [GET /transformations/get-all/ — Get All Transformation](/hook/transformation/get-all-transformation)
- [PUT /transformations/{{transformationId}} — Update Transformation By Trs_id](/hook/transformation/update-transformation-by-trs-id)
- [DELETE /transformations/{{transformationId}} — Delete Transformation Based On Trs_id](/hook/transformation/delete-transformation-based-on-trs-id)